SetupAPI 文本日志

在 Windows Vista 和更高版本的 Windows 中, SetupAPI 支持设备安装文本日志 (SetupAPI.dev.log) 和应用程序安装文本日志 (SetupAPI.app.log) 。 即插即用 (PnP) 管理器和 SetupAPI 将条目写入设备安装文本日志,以提供有关安装设备和驱动程序的操作的信息。 PnP 管理器和 SetupAPI 将条目写入应用程序安装文本日志,这些条目提供有关安装操作的信息,但与设备和驱动程序安装相关的操作除外。

安装应用程序、类安装程序和共同安装程序可以使用 SetupAPI 日志记录函数 将条目写入设备安装日志和应用程序安装文本日志。

SetupAPI 文本日志是 ANSI 纯文本文件,默认情况下位于 %SystemRoot%\inf 目录中。 文本日志采用英语 (标准) 语言。

SetupAPI 文本日志具有以下内部格式:

  • 日志条目是文本日志中的一行。

  • 前几个日志条目提供 一个文本日志标头 ,其中包含有关操作系统和计算机体系结构的信息。 有关详细信息,请参阅 文本日志标头的格式

  • 文本日志标头后面的是零个或多个 文本日志部分。 每个文本日志部分记录单个设备安装期间的事件。

    文本日志节的目的是对提供特定安装操作相关信息的连续日志条目序列进行分组和格式化。 通过创建文本日志部分,PnP 管理器、SetupAPI 或自定义安装应用程序可以以概念上有意义的方式组织日志条目。 例如,PnP 管理器可能会创建一个文本日志部分,以对适用于安装设备的所有日志条目进行分组。 文本日志分区按创建顺序显示在文本日志中。 有关详细信息,请参阅 文本日志的格式部分

  • 文本日志可以包含不属于文本日志标头或文本日志部分的日志条目。 此类条目与不属于任何特定文本日志节的操作相关联,并且通常交错在文本日志节之间。 不属于文本日志部分的日志条目以写入文本日志的相同顺序显示在日志中。 有关此类日志条目的详细信息,请参阅 不属于文本日志的日志条目的格式部分