文本日志部分的格式

文本日志节包括一个用于打开节的节标题、一个包含应用于节操作的日志条目序列的节正文,以及一个用于关闭节的节页脚。 节条目按写入节的顺序显示在节中。

下面的文本日志部分示例显示了典型节的一般格式,其中斜体字体样式的字段是特定于节的文本的占位符,而粗体字体样式的其余文本是 SetupAPI 提供的通用文本。 前两个日志条目包括节标头,最后两个日志条目构成节页脚。

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

记录的节正文条目取决于为日志设置的事件级别和为日志启用的类别级别。 有关这些设置的详细信息,请参阅 安装程序API 日志记录注册表设置

下面是即插即用 (PnP) 管理器创建的文本日志部分的典型示例,用于记录与 PCI 设备安装相关的条目。 在节标头中, section_title 字段为“设备安装”, instance_identifier 字段是设备实例标识符“PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38”, time_stamp 字段为“2005/02/13 22:06:28.109:”。在节页脚中, status_value 字段为“0x00000000”, time_stamp 字段为“2005/02/13 22:06:20.000:”。此示例中仅包含前三节正文日志条目。 此示例的事件级别设置为 TXTLOG_DETAILS,并且为此示例启用了所有类别级别。

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

有关文本日志部分的内容和格式的详细信息,请参阅 文本日志节标题的格式文本日志节正文的格式文本日志节页脚的格式