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

Текст раздела текстового журнала содержит ноль или несколько записей журнала, которые применяются к операции, связанной с текстовым разделом журнала. Формат записи в журнале текста раздела включает поле entry_prefix , поле time_stamp , поле event_category , поле отступа и поле formatted_message следующим образом:

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

Поле entry_prefix
Указывает, является ли запись журнала сообщением об ошибке, предупреждением или информационным сообщением. Поле entry_prefix всегда присутствует и содержит одну из строк, перечисленных в следующей таблице:

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

поле time_stamp
Указывает системное время, когда произошло зарегистрированное событие. Поле time_stamp является необязательным, и setupAPI не включает метку времени по умолчанию. Однако SetupWriteTextLog поддерживает включение метки времени в запись журнала. Формат поля time_stamp совпадает с форматом поля time_stamp , описанным в разделе Формат заголовка раздела текстового журнала.

Поле event_category
Указывает категорию операции SetupAPI, которая внесла запись журнала. Поле event_category обычно присутствует, но не является обязательным. Если поле event_category присутствует, оно будет содержать одну из строк, перечисленных в следующей таблице:

строки полей Event_category	Операция setupAPI
"...: "	Операция, предоставляемая поставщиком
"bak: "	Архивация данных
"cci: "	Установщик класса или операция совместного установщика
"cpy: "	Копирование файлов
"dvi: "	Установка устройств
"flq: "	Управление очередями файлов
"inf: "	Управление INF-файлами
"ndv: "	Мастер создания устройств
"prp: "	Управление свойствами устройства и драйвера
"reg: "	Управление параметрами реестра
"set: "	Общая настройка
"sig: "	Проверка цифровых подписей
"sto: "	Управление хранилищем драйверов
"ui : "	Диалоговое окно "Управление пользовательским интерфейсом"
"ump: "	Диспетчер PnP в пользовательском режиме

Поле отступа
Состоит из последовательности из нуля или более единиц отступа, где единицей отступа является строка монопространства, содержащая пять пробелов. Поле отступа является необязательным, и setupAPI не включает отступы по умолчанию. SetupWriteTextLog поддерживает изменение количества единиц отступа, включенных в запись журнала.

поле formatted_message
Содержит конкретные сведения, относящиеся к записи журнала.

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

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