INF DDInstall.Events section
Each per-Models DDInstall.Events section contains one or more INF AddEventProvider directives, AddAutoLogger or UpdateAutoLogger that reference additional INF-writer-defined sections in an INF file. This section is supported for Windows 10 version 1809 and later.
[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]...]
You can provide a DDInstall.Events section with at least one AddEventProvider directive to register Event Tracing for Windows (ETW) providers. You can also provide one or more AddAutoLogger directives to Configure and Start an AutoLogger Session and UpdateAutoLogger directives to add AutoLogger providers to an existing AutoLogger session.
Entries
AddEventProvider={ProviderGUID},event-provider-install-section
This directive references an INF-writer-defined event-provider-install-section elsewhere in the INF file for the drivers of the devices covered by this DDInstall section. For more information, see INF AddEventProvider Directive.
AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
This directive references an INF-writer-defined add-autologger-install-section elsewhere in the INF file for the drivers of the devices covered by this DDInstall section. For more information, see INF AddAutoLogger and UpdateAutoLogger Directives.
UpdateAutoLogger=session-name,update-autologger-install-section
This directive references an INF-writer-defined update-autologger-install-section elsewhere in the INF file for the drivers of the devices covered by this DDInstall section. For more information, see INF AddAutoLogger and UpdateAutoLogger Directives.
Include=filename.inf[,filename2.inf]...
This optional entry specifies one or more additional system-supplied INF files that contain sections needed to install this device. If this entry is specified, a Needs entry is also usually required.
Needs=inf-section-name[,inf-section-name]...
This optional entry specifies the section that must be processed during the installation of this device. Typically, the section is a DDInstall.Events section within a system-supplied INF file that is listed in an Include entry. However, it can be any section that is referenced within a DDInstall.Events section.
Remarks
DDInstall.Events sections should have the same platform and operating system decorations as their related DDInstall sections. For example, an install-section-name.ntx86 section would have a corresponding install-section-name.ntx86.Events section.
The specified DDInstall section must be referenced in a device/models-specific entry under the per-manufacturer Models section of the INF file. The case-insensitive extensions to the install-section-name shown in the formal syntax statement can be inserted into such a DDInstall.Events section name in cross-platform INF files.
For more information about how to use the system-defined .nt, .ntx86, .ntia64, .ntamd64, .ntarm, and .ntarm64 extensions, see Creating INF Files for Multiple Platforms and Operating Systems.
Examples
This example shows the install-section-name.Events section and its event-provider-install-sections, add-autologger-install-sections, and update-autologger-install-sections in the INF file.
[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]
; ...