Sekcja INF DDInstall.Events

Każdy model DDInstall. Sekcja Zdarzenia zawiera co najmniej jedną dyrektywę INF AddEventProvider, AddAutoLogger lub UpdateAutoLogger odwołującą się do dodatkowych sekcji zdefiniowanych przez moduł zapisywania INF w pliku INF. Ta sekcja jest obsługiwana w przypadku Windows 10 w wersji 1809 lub nowszej.

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

Możesz podać DDInstall. Sekcja Zdarzenia z co najmniej jedną dyrektywą AddEventProvider w celu zarejestrowania śledzenia zdarzeń dla dostawców Windows (ETW). Można również podać co najmniej jedną dyrektywę AddAutoLogger , aby skonfigurować i uruchomić sesję autologera i dyrektywy UpdateAutoLogger , aby dodać dostawców autologera do istniejącej sesji autologera.

Wpisy

AddEventProvider={ProviderGUID},event-provider-install-section
Ta dyrektywa odwołuje się do sekcji event-provider-install-zdefiniowanej przez moduł zapisywania INF w innym miejscu w pliku INF dla sterowników urządzeń objętych tą sekcją DDInstall . Aby uzyskać więcej informacji, zobacz INF AddEventProvider, dyrektywa.

AddAutoLogger=nazwa-sesji,{SessionGUID},add-autologger-install-section
Ta dyrektywa odwołuje się do sekcji add-autologger-install-section zdefiniowanej przez moduł zapisywania INF w innym miejscu w pliku INF dla sterowników urządzeń objętych tą sekcją DDInstall . Aby uzyskać więcej informacji, zobacz dyrektywy INF AddAutoLogger i UpdateAutoLogger.

UpdateAutoLogger=nazwa-sesji,update-autologger-install-section
Ta dyrektywa odwołuje się do sekcji update-autologger-install-section zdefiniowanej przez moduł zapisywania INF w innym miejscu w pliku INF dla sterowników urządzeń objętych tą sekcją DDInstall . Aby uzyskać więcej informacji, zobacz dyrektywy INF AddAutoLogger i UpdateAutoLogger.

Include=nazwa pliku. inf[,nazwa_pliku2.inf]...
Ten opcjonalny wpis określa jeden lub więcej dodatkowych plików INF dostarczanych przez system, które zawierają sekcje wymagane do zainstalowania tego urządzenia. Jeśli ten wpis jest określony, zazwyczaj wymagany jest wpis Wymaga .

Needs=inf-section-name[,inf-section-name]...
Ten opcjonalny wpis określa sekcję, która musi zostać przetworzona podczas instalacji tego urządzenia. Zazwyczaj sekcja jest DDInstall. Sekcja Zdarzenia w pliku INF dostarczonym przez system, który znajduje się w wpisie Dołączanie . Jednak może to być dowolna sekcja, do którego odwołuje się element DDInstall. Sekcja Zdarzenia .

Remarks

DDInstall. Sekcje zdarzeń powinny mieć taką samą platformę i dekoracje systemu operacyjnego, jak powiązane sekcje DDInstall . Na przykład nazwa-sekcji instalacji. Sekcja ntx86 będzie mieć odpowiednią nazwę install-section-name. ntx86. Sekcja Zdarzenia .

Określona sekcja DDInstall musi odwoływać się do wpisu specyficznego dla urządzenia/modeli w sekcji Modele dla poszczególnych producentów pliku INF. Rozszerzenia bez uwzględniania wielkości liter w nazwie install-section-name wyświetlanej w instrukcji składni formalnej można wstawić do takiej instalacji DDInstall. Nazwa sekcji zdarzeń w plikach INF międzyplatformowych.

Aby uzyskać więcej informacji na temat używania zdefiniowanych przez system rozszerzeń nt, ntx86, ntia64, ntamd64, ntarm i ntarm64 , zobacz Tworzenie plików INF dla wielu platform i systemów operacyjnych.

Examples

W tym przykładzie przedstawiono nazwę install-section-name. Sekcja zdarzeń i jej sekcje event-provider-install-section, add-autologger-install-section i update-autologger-install-section w pliku INF.

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

Informacje dodatkowe

AddEventProvider

AddAutoLogger i UpdateAutoLogger

DDInstall