INF DDInstall.Events 部分

每个模型 DDInstallEvents 节包含一个或多个 INF AddEventProvider 指令AddAutoLoggerUpdateAutoLogger ,这些指令引用 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=filenameinf[,filename2.inf]...
此可选条目指定一个或多个系统提供的其他 INF 文件,其中包含安装此设备所需的部分。 如果指定了此项,则通常还需要 “需要” 条目。

Needs=inf-section-name[,inf-section-name]...
此可选条目指定在安装此设备期间必须处理的节。 通常, 节是 DDInstall。包含项中列出的系统提供的 INF 文件中的事件部分。 但是,它可以是 DDInstall 中引用的任何节。“事件” 部分。

注解

DDInstall事件 部分应具有与其相关的 DDInstall 部分相同的平台和操作系统修饰。 例如, install-section-namentx86 节将具有相应的 install-section-namentx86。“事件” 部分。

指定的 DDInstall 节必须在 INF 文件的“按制造商模型”部分下特定于设备/ 型号 的条目中引用。 可以将正式语法语句中显示的 install-section-name 不区分大小写的扩展插入到此类 DDInstall 中。跨平台 INF 文件中的事件 节名称。

有关如何使用系统定义的 .nt.ntx86.ntia64.ntamd64.ntarm.ntarm64 扩展的详细信息,请参阅 为多个平台和操作系统创建 INF 文件

示例

此示例显示 install-section-nameINF 文件中的事件 部分及其 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] 
; ... 

另请参阅

AddEventProvider

AddAutoLogger 和 UpdateAutoLogger

DDInstall