ABSCHNITT "INF DDInstall.Events"

Jede pro Modelle DDInstall. Der Abschnitt "Ereignisse " enthält eine oder mehrere INF-AddEventProvider-Direktiven, AddAutoLogger oder UpdateAutoLogger , die auf zusätzliche INF-Writer-definierte Abschnitte in einer INF-Datei verweisen. Dieser Abschnitt wird für Windows 10 Version 1809 und höher unterstützt.

[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]...] 

Sie können einen DDInstall bereitstellen. Abschnitt "Ereignisse" mit mindestens einer AddEventProvider-Direktive zum Registrieren der Ereignisablaufverfolgung für Windows(ETW)-Anbieter. Sie können auch eine oder mehrere AddAutoLogger-Direktiven zum Konfigurieren und Starten einer AutoLogger-Sitzung und UpdateAutoLogger-Direktiven bereitstellen, um AutoLogger-Anbieter zu einer vorhandenen AutoLogger-Sitzung hinzuzufügen.

Einträge

AddEventProvider={ProviderGUID},event-provider-install-section
Diese Direktive verweist auf einen INF-writer-defined Event-provider-install-section an anderer Stelle in der INF-Datei für die Treiber der Geräte, die von diesem DDInstall-Abschnitt abgedeckt werden. Weitere Informationen finden Sie unter INF AddEventProvider-Direktive.

AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
Diese Direktive verweist auf einen INF-writer-defined Add-autologger-install-section an anderer Stelle in der INF-Datei für die Treiber der Geräte, die von diesem DDInstall-Abschnitt abgedeckt werden. Weitere Informationen finden Sie unter INF AddAutoLogger- und UpdateAutoLogger-Direktiven.

UpdateAutoLogger=session-name,update-autologger-install-section
Diese Direktive verweist auf einen INF-writer-defined Update-autologger-install-section an anderer Stelle in der INF-Datei für die Treiber der Geräte, die von diesem Abschnitt "DDInstall " abgedeckt werden. Weitere Informationen finden Sie unter INF AddAutoLogger- und UpdateAutoLogger-Direktiven.

Include=filename. inf[,Dateiname2.inf]...
Dieser optionale Eintrag gibt eine oder mehrere zusätzliche vom System bereitgestellte INF-Dateien an, die Abschnitte enthalten, die zum Installieren dieses Geräts erforderlich sind. Wenn dieser Eintrag angegeben ist, ist in der Regel auch ein Bedarfseintrag erforderlich.

Needs=inf-section-name[,inf-section-name]...
Dieser optionale Eintrag gibt den Abschnitt an, der während der Installation dieses Geräts verarbeitet werden muss. In der Regel ist der Abschnitt ein DDInstall. Ereignisabschnitt in einer vom System bereitgestellten INF-Datei, die in einem Include-Eintrag aufgeführt ist. Es kann jedoch ein beliebiger Abschnitt sein, auf den in einem DDInstall verwiesen wird. Abschnitt "Ereignisse ".

Bemerkungen

DDInstall. Ereignisabschnitte sollten die gleichen Plattform- und Betriebssystem-Dekorationen wie die zugehörigen DDInstall-Abschnitte aufweisen. Beispiel: ein Install-Section-Name. Ntx86-Abschnitt hätte einen entsprechenden Installationsabschnittsnamen. ntx86. Abschnitt "Ereignisse ".

Auf den angegebenen DDInstall-Abschnitt muss in einem geräte-/modellspezifischen Eintrag im Abschnitt " Modelle pro Hersteller" der INF-Datei verwiesen werden. Die in der formalen Syntax-Anweisung gezeigten Installationsabschnittserweiterungen können in einen solchen DDInstall eingefügt werden. Name des Abschnitts "Ereignisse " in plattformübergreifenden INF-Dateien.

Weitere Informationen zur Verwendung der systemdefinierten . nt-, .ntx86-, .ntia64-, .ntamd64-, .ntarm- und .ntarm64-Erweiterungen finden Sie unter Creating INF Files for Multiple Platforms and Operating Systems.

Examples

In diesem Beispiel wird der Name des Installationsabschnitts veranschaulicht. Abschnitt "Events " und "event-provider-install-sections", "add-autologger-install-sections" und "update-autologger-install-sections" in der INF-Datei.

[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] 
; ... 

Siehe auch

AddEventProvider

AddAutoLogger und UpdateAutoLogger

DDInstall