Formato do corpo de uma seção de log de texto

Um corpo da seção de log de texto contém zero ou mais entradas de log que se aplicam à operação associada a uma seção de log de texto. The format of a section body log entry includes an entry_prefix field, a time_stamp field, an event_category field, an indentation field, and a formatted_message field, as follows:

entry_prefix time_stamp event_category formatted_message de recuo
O comprimento máximo, em caracteres, de uma entrada de log do corpo da seção é 336.

entry_prefix field
Indica se a entrada de log é uma mensagem de erro, uma mensagem de aviso ou uma mensagem de informação. The entry_prefix field is always present and contains one of the strings that are listed in the following table:

time_stamp field
Indica a hora do sistema em que o evento registrado ocorreu. The time_stamp field is optional and SetupAPI doesn't include a time stamp by default. However, SetupWriteTextLog supports including a time stamp in a log entry. The format of the time_stamp field is the same as the format of the time_stamp field that is described in Format of a Text Log Section Header.

event_category field
Indica a categoria da operação SetupAPI que fez a entrada de log. The event_category field is usually present, but isn't required. If the event_category field is present, it will contain one of the strings that are listed in the following table:

indentation field
Consists of a sequence of zero or more indentation units, where an indentation unit is a monospace string that contains five spaces. The indentation field is optional and SetupAPI doesn't include indentation by default. SetupWriteTextLog supports changing the number of indentation units that are included in a log entry.

formatted_message field
Contém as informações específicas que se aplicam à entrada de log.

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

Quando SetupAPI cria uma seção que agrupa operações que se aplicam a uma instalação de dispositivo, ela também agrupa recursivamente entradas de log do corpo da seção em subseções. SetupAPI distingue as subseções pela maneira como anota e registra entradas de log. Uma dessas subseções aparece no trecho a seguir de uma seção de instalação típica do dispositivo. A subseção começa com a entrada de log "dvi: {Build Driver List}" e termina com a entrada de log "dvi: {Build Driver List - exit(0x00000000)}". This subsection shows a typical sequence of log entries that include the entry_prefix, event_category, indentation, and formatted_message fields. As operações SetupAPI que escreveram as entradas de log também criaram o recuo e forneceram o conteúdo das mensagens formatadas. 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:28.109: Section start
...
 Additional section body log entries
...
     dvi: {Build Driver List}
     dvi:      Enumerating all INFs...
     dvi:      Found driver match:
     dvi:           HardwareID - PCI\VEN_104C&DEV_8019
     dvi:           InfName    - C:\WINDOWS\inf\1394.inf
     dvi:           DevDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           DrvDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           Provider   - Microsoft
     dvi:           Mfg        - Texas Instruments
     dvi:           InstallSec - TIOHCI_Install
     dvi:           ActualSec  - TIOHCI_Install.NT
     dvi:           Rank       - 0x00002001
     dvi:           DrvDate    - 10/01/2002
     dvi:           Version    - 6.0.5033.0 
!!!  inf:      InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
     dvi: {Build Driver List - exit(0x00000000)}
...
 Additional section body log entries 
...
<<<  [2005/02/13 22:06:29.000: Section end]
<<<  [Exit Status(0x00000000)]