Registos de Texto do SetupAPI

In Windows Vista and later versions of Windows, SetupAPI supports a device installation text log (SetupAPI.dev.log) and an application installation text log (SetupAPI.app.log). O gerenciador Plug and Play (PnP) e a API Setupgravam entradas no log de texto de instalação do dispositivo para fornecer informações sobre operações que instalam dispositivos e drivers. O gerenciador PnP e a SetupAPI gravam entradas no log de texto de instalação do aplicativo que fornecem informações sobre operações de instalação diferentes daquelas que pertencem especificamente a instalações de dispositivos e drivers.

Aplicativos de instalação, instaladores de classe e coinstaladores podem usar as funções de log SetupAPI para gravar entradas no log de instalação do dispositivo e no log de texto de instalação do aplicativo.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Os logs de texto estão no idioma inglês (padrão).

Os logs de texto SetupAPI têm o seguinte formato interno:

• A log entry is one line in a text log.

• As primeiras entradas de log fornecem um cabeçalho de log de texto que contém informações sobre o sistema operacional e a arquitetura do computador. Para obter mais informações, consulte Formato de um cabeçalho de log de texto.

• Seguindo o cabeçalho do log de texto estão zero ou mais seções de log de texto. Cada seção de log de texto registra os eventos durante a instalação de um único dispositivo.

  O objetivo de uma seção de log de texto é agrupar e formatar uma sequência contígua de entradas de log que fornecem informações sobre uma operação de instalação específica. Ao criar seções de log de texto, o gerenciador PnP, SetupAPI ou um aplicativo de instalação personalizado pode organizar entradas de log de uma maneira conceitualmente significativa. Por exemplo, o gerenciador PnP pode criar uma seção de log de texto para agrupar todas as entradas de log que se aplicam à instalação de um dispositivo. As seções de log de texto aparecem em um log de texto na ordem em que são criadas. Para obter mais informações, consulte Seção Formato de um log de texto.

• Um log de texto pode conter entradas de log que não fazem parte do cabeçalho do log de texto ou de uma seção de log de texto. Essas entradas estão associadas a operações que não fazem parte de nenhuma seção de log de texto específica e, em geral, são intercaladas entre seções de log de texto. As entradas de log que não fazem parte de uma seção de log de texto aparecem no log na mesma ordem em que são gravadas no log de texto. Para obter mais informações sobre essas entradas de log, consulte Formato de entradas de log que não fazem parte de uma seção de log de texto.