在 Windows Vista 及更高版本的 Windows 中,SetupAPI 支持设备安装文本日志(SetupAPI.dev.log)和应用程序安装文本日志(SetupAPI.app.log)。 即插即用(PnP)管理器和 SetupAPI 将条目写入设备安装文本日志,以提供有关安装设备和驱动程序的作的信息。 PnP 管理器和 SetupAPI 将条目写入应用程序安装文本日志,这些日志提供有关特定于设备和驱动程序安装的安装作的信息。
安装应用程序、类安装程序和共同安装程序可以使用 SetupAPI 日志记录函数 将条目写入设备安装日志和应用程序安装文本日志。
SetupAPI 文本日志是 ANSI 纯文本文件,默认情况下位于 %SystemRoot%\inf 目录中。 文本日志采用英语(标准)语言。
SetupAPI 文本日志具有以下内部格式:
日志条目是文本日志中的一行。
前几个日志条目提供一个 文本日志标头 ,其中包含有关作系统和计算机体系结构的信息。 有关详细信息,请参阅 文本日志标头的格式。
遵循文本日志标头为零个或多个 文本日志部分。 每个文本日志记录在单个设备安装期间的事件。
文本日志部分的目的是对一系列连续的日志条目进行分组和格式化,这些条目提供有关特定安装作的信息。 通过创建文本日志部分,PnP 管理器、SetupAPI 或自定义安装应用程序可以以概念有意义的方式组织日志条目。 例如,PnP 管理器可能会创建一个文本日志部分来对应用于安装设备的所有日志条目进行分组。 文本日志部分以创建文本日志的顺序显示在文本日志中。 有关详细信息,请参阅 “文本日志格式”部分。
文本日志可以包含不属于文本日志标头或文本日志部分的日志条目。 此类条目与不属于任何特定文本日志部分的作相关联,一般情况下,这些条目在文本日志节之间交错。 不属于文本日志部分的日志条目以写入文本日志的顺序显示在日志中。 有关此类日志条目的详细信息,请参阅 不属于文本日志部分的日志条目的格式。