Compartilhar via


Formato de uma seção de log de texto

Uma seção de log de texto inclui um cabeçalho de seção que abre a seção, um corpo de seção que inclui uma sequência de entradas de log que se aplicam à operação de seção e um rodapé de seção que fecha a seção. As entradas de seção aparecem em uma seção na mesma ordem em que são gravadas na seção.

O exemplo a seguir de uma seção de log de texto mostra o formato geral de uma seção típica, em que os campos no estilo de fonte itálico são espaços reservados para texto específico da seção e o texto restante em negrito é um texto genérico fornecido pela SetupAPI. As duas primeiras entradas de log compõem o cabeçalho da seção e as duas últimas entradas de log compõem o rodapé da seção.

>>>  [section_title - instance_identifier]
>>> time_stamp Section start
 section body log entry
 section body log entry
 section body log entry
<<<  [time_stamp: Section end]
<<<  [Exit Status(status_value)]

As entradas do corpo da seção registradas dependem do nível de evento definido para o log e os níveis de categoria que estão habilitados para o log. Para obter mais informações sobre essas configurações, consulte SetupAPI Logging Registry Settings.

Veja a seguir um exemplo típico de uma seção de log de texto que o gerenciador de Plug and Play (PnP) criou para registrar entradas que pertenciam à instalação de um dispositivo PCI. No cabeçalho da seção, o campo section_title é "Instalação do Dispositivo", o campo instance_identifier é o identificador de instância do dispositivo "PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38" e o campo time_stamp é "2005/02/13 22:06:28.109:." No rodapé da seção, o campo status_value é "0x00000000" e o campo time_stamp é "2005/02/13 22:06:20.000:". Somente as três primeiras entradas de log do corpo da seção são incluídas neste exemplo. O nível de evento deste exemplo foi definido como TXTLOG_DETAILS e todos os níveis de categoria foram habilitados para este exemplo.

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:20.000: Section start
     ndv: Retrieving device info...
     ndv: Setting device parameters...
     ndv: Building driver list...
...  
...  additional section body log entries, which are not shown
...  
<<<  [2005/02/13 22:06:28.109: Section end]
<<<  [Exit Status(0x00000000)]

Para obter informações detalhadas sobre o conteúdo e o formato de uma seção de log de texto, consulte Format of a Text Log Section Header, Format of a Text Log Section Body e Format of a Text Log Section Footer.