Формат текста раздела журнала текста

Текст раздела текстового журнала содержит ноль или больше записей журнала, которые применяются к операции, связанной с текстовым разделом журнала. 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:

formatted_message отступов entry_prefix time_stamp event_category
Максимальная длина в символах записи журнала текста раздела составляет 336.

entry_prefix field
Указывает, является ли запись журнала сообщением об ошибке, предупреждающим сообщением или информационным сообщением. The entry_prefix field is always present and contains one of the strings that are listed in the following table:

Entry_prefix field Тип сообщения
"!!!    " Сообщение об ошибке
"!      " Предупреждение
" " Информационное сообщение, отличное от сообщения об ошибке или предупреждающего сообщения

time_stamp field
Указывает системное время, когда произошло событие журнала. 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
Указывает категорию операции SetupAPI, которая сделала запись журнала. 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:

Event_category field strings SetupAPI operation
"...: " Vendor-supplied operation
"bak: " Backup data
"cci: " Операция установщика классов или совместного установщика
"cpy: " Copy files
"dvi: " Device installation
"flq: " Управление очередями файлов
"inf: " Управление INF-файлами
"ndv: " Мастер создания устройств
"prp: " Управление свойствами устройства и драйвера
"reg: " Управление параметрами реестра
"set: " General setup
"sig: " Проверка цифровых подписей
"sto: " Управление хранилищем драйверов
"ui : " Управление диалоговыми окнами пользовательского интерфейса
"ump: " Диспетчер PnP в пользовательском режиме

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
Содержит конкретные сведения, относящиеся к записи журнала.

Записи текста раздела, зарегистрированные в журнале, зависят от уровня событий, заданного для журнала и уровней категорий, включенных для журнала. Дополнительные сведения об этих параметрах см. в разделе "Параметры реестра ведения журнала SetupAPI".

Когда SetupAPI создает раздел, который группирует операции, применяемые к установке устройства, он также рекурсивно группирует записи журнала раздела в подразделах. SetupAPI различает подразделы таким образом, как он аннотирует и отступы записей журнала. Один из таких подразделов отображается в следующем фрагменте из типичного раздела установки устройства. Подраздел начинается с записи журнала "dvi: {Build Driver List}" и заканчивается записью журнала "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. Операции SetupAPI, которые написали записи журнала, также создали отступ и предоставили содержимое отформатированных сообщений. Для этого примера задан уровень событий TXTLOG_DETAILS, а для этого примера включены все уровни категорий.

>>>  [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)]
  • Last updated on