INF DDInstall.Events 部分
每个模型 DDInstall。Events 节包含一个或多个 INF AddEventProvider 指令、 AddAutoLogger 或 UpdateAutoLogger ,这些指令引用 INF 文件中其他 INF 编写器定义的节。 Windows 10版本 1809 及更高版本支持此部分。
[install-section-name.Events] |
[install-section-name.nt.Events] |
[install-section-name.ntx86.Events] |
[install-section-name.ntia64.Events] |
[install-section-name.ntamd64.Events] |
[install-section-name.ntarm.Events] |
[install-section-name.ntarm64.Events]
AddEventProvider={ProviderGUID},event-provider-install-section
AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
UpdateAutoLogger=session-name,update-autologger-install-section
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
可以提供 DDInstall。包含 至少一个 AddEventProvider 指令的事件部分, 用于注册 Windows (ETW 事件跟踪) 提供程序。 还可以提供一个或多个 AddAutoLogger 指令来 配置和启动 AutoLogger 会话 ,并提供 UpdateAutoLogger 指令以将 AutoLogger 提供程序添加到现有 AutoLogger 会话。
项
AddEventProvider={ProviderGUID},event-provider-install-section
此指令引用 INF 文件中其他位置的 INF 编写器定义的 event-provider-install-section ,用于此 DDInstall 部分涵盖的设备驱动程序。 有关详细信息,请参阅 INF AddEventProvider 指令。
AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
此指令引用 INF 文件中其他位置的 INF 编写器定义的 add-autologger-install-section ,用于此 DDInstall 部分涵盖的设备驱动程序。 有关详细信息,请参阅 INF AddAutoLogger 和 UpdateAutoLogger 指令。
UpdateAutoLogger=session-name,update-autologger-install-section
此指令引用 INF 文件中其他位置的 INF 编写器定义的 update-autologger-install-section ,用于此 DDInstall 部分涵盖的设备驱动程序。 有关详细信息,请参阅 INF AddAutoLogger 和 UpdateAutoLogger 指令。
Include=filename。inf[,filename2.inf]...
此可选条目指定一个或多个系统提供的其他 INF 文件,其中包含安装此设备所需的部分。 如果指定了此项,则通常还需要 “需要” 条目。
Needs=inf-section-name[,inf-section-name]...
此可选条目指定在安装此设备期间必须处理的节。 通常, 节是 DDInstall。包含项中列出的系统提供的 INF 文件中的事件部分。 但是,它可以是 DDInstall 中引用的任何节。“事件” 部分。
注解
DDInstall。事件 部分应具有与其相关的 DDInstall 部分相同的平台和操作系统修饰。 例如, install-section-name。ntx86 节将具有相应的 install-section-name。ntx86。“事件” 部分。
指定的 DDInstall 节必须在 INF 文件的“按制造商模型”部分下特定于设备/ 型号 的条目中引用。 可以将正式语法语句中显示的 install-section-name 不区分大小写的扩展插入到此类 DDInstall 中。跨平台 INF 文件中的事件 节名称。
有关如何使用系统定义的 .nt、 .ntx86、 .ntia64、 .ntamd64、 .ntarm 和 .ntarm64 扩展的详细信息,请参阅 为多个平台和操作系统创建 INF 文件。
示例
此示例显示 install-section-name。INF 文件中的事件 部分及其 event-provider-install-section、add-autologger-install-section 和 update-autologger-install-section。
[Device_Inst.NT.Events]
AddEventProvider={071acb53-ccfb-42e0-9a68-5336b7301507},Contoso_Event_Provider_1_Inst
AddEventProvider={6d3fd9ef-bcbb-42d7-9fbd-1bf2d926b394},Contoso_Event_Provider_2_Inst
AddAutoLogger=ContosoAddSession,{d9ff08ce-a7a6-4c44-91e9-bc1e3692301b},Contoso_Add_AutoLogger_Inst
UpdateAutoLogger=ContosoUpdateSession,Contoso_Update_AutoLogger_Inst
; entries in the following xxx_Inst sections omitted here for brevity,
; but fully specified as the example for the AddEventProvider,
; AddAutoLogger, and UpdateAutoLogger directives
;
[Contoso_Event_Provider_1_Inst]
; ...
[Contoso_Event_Provider_2_Inst]
; ...
[Contoso_Add_AutoLogger_Inst]
; ...
[Contoso_Update_AutoLogger_Inst]
; ...