Logs de texto 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 do PnP (Plug and Play) e as entradas de gravação de SetupAPI 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 as entradas de gravação de SetupAPI no log de texto de instalação do aplicativo que fornecem informações sobre operações de instalação diferentes daquelas que pertencem especificamente às instalações de dispositivo e driver.

Aplicativos de instalação, instaladores de classe e co-instaladores podem usar as funções de log de 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 (Standard).

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 uma única instalação do dispositivo.

  A finalidade 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, o SetupAPI ou um aplicativo de instalação personalizado podem organizar entradas de log de 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 Formato de uma Seção de 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 sã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. 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.