文本日志部分正文的格式

项目
03/08/2023

文本日志节正文包含零个或多个应用于与文本日志节关联的操作的日志条目。节正文日志条目的格式包括 entry_prefix 字段、 time_stamp 字段、 event_category 字段、缩进字段和 formatted_message 字段，如下所示：

entry_prefix time_stamp event_category缩进formatted_message
节正文日志条目的最大长度（以字符为单位）为 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 日志记录注册表设置。

当 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)]

通过

文本日志部分正文的格式

反馈

其他资源