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-writer-defined event-provider-install-section,该 INF 文件中其他位置用于此 DDInstall 节涵盖的设备驱动程序。 有关详细信息,请参阅 INF AddEventProvider 指令

AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
此指令引用 INF 文件中其他位置的 INF 编写 器定义的 add-autologger-install-section ,了解此 DDInstall 节涵盖的设备驱动程序。 有关详细信息,请参阅 INF AddAutoLogger 和 UpdateAutoLogger 指令

UpdateAutoLogger=session-nameupdate-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 文件中的事件部分, 该文件列在 Include 条目中。 但是,它可以是 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-nameEvents 节及其 event-provider-install-sections、add-autologger-install-sections 和 INF 文件中的 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