Sección INF DDInstall.Events

Cada DDInstall por modelo. La sección Eventos contiene una o varias directivas AddEventProvider de INF, AddAutoLogger o UpdateAutoLogger que hacen referencia a secciones adicionales definidas por INF-writer en un archivo INF. Esta sección es compatible con Windows 10 versión 1809 y posteriores.

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

Puede proporcionar un DDInstall. Sección eventos con al menos una directiva AddEventProvider para registrar el seguimiento de eventos para proveedores de Windows (ETW). También puede proporcionar una o varias directivas AddAutoLogger para configurar e iniciar una sesión de AutoLogger y updateAutoLogger directivas para agregar proveedores de AutoLogger a una sesión de AutoLogger existente.

Entradas

AddEventProvider={ProviderGUID},event-provider-install-section
Esta directiva hace referencia a una sección inf-writer-fined event-provider-install-section en otra parte del archivo INF para los controladores de los dispositivos cubiertos por esta sección DDInstall . Para obtener más información, vea INF AddEventProvider (Directiva) de INF.

AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
Esta directiva hace referencia a una sección INF-writer-defined add-autologger-install-section en otra parte del archivo INF para los controladores de los dispositivos cubiertos por esta sección DDInstall . Para obtener más información, vea INF AddAutoLogger y UpdateAutoLogger Directivas.

UpdateAutoLogger=session-name,update-autologger-install-section
Esta directiva hace referencia a una sección update-autologger-install-install-section definida por INF para los controladores de los dispositivos cubiertos por esta sección DDInstall . Para obtener más información, vea INF AddAutoLogger y UpdateAutoLogger Directivas.

Include=filename. inf[,filename2.inf]...
Esta entrada opcional especifica uno o varios archivos INF adicionales proporcionados por el sistema que contienen secciones necesarias para instalar este dispositivo. Si se especifica esta entrada, normalmente se requiere una entrada Needs .

Needs=inf-section-name[,inf-section-name]...
Esta entrada opcional especifica la sección que se debe procesar durante la instalación de este dispositivo. Normalmente, la sección es DDInstall. Sección eventos dentro de un archivo INF proporcionado por el sistema que aparece en una entrada Include . Sin embargo, puede ser cualquier sección a la que se haga referencia dentro de un DDInstall. Sección Eventos .

Remarks

DDInstall. Las secciones de eventos deben tener las mismas decoraciones de plataforma y sistema operativo que sus secciones DDInstall relacionadas. Por ejemplo, un install-section-name. La sección ntx86 tendría un nombre de sección de instalación correspondiente. ntx86. Sección Eventos .

Se debe hacer referencia a la sección DDInstall especificada en una entrada específica de dispositivos o modelos en la sección Modelos por fabricante del archivo INF. Las extensiones que no distinguen mayúsculas de minúsculas al nombre de la sección install-section que se muestra en la instrucción de sintaxis formal se pueden insertar en dicho DDInstall. Nombre de sección de eventos en archivos INF multiplataforma.

Para obtener más información sobre cómo usar las extensiones .nt, .ntx86, .ntia64, .ntamd64, .ntarm y .ntarm64 definidas por el sistema, vea Creación de archivos INF para varias plataformas y sistemas operativos.

Examples

En este ejemplo se muestra el nombre de install-section-name. Sección eventos y sus secciones event-provider-install-sections, add-autologger-install-sections y update-autologger-install-sections en el archivo 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] 
; ... 

Consulte también

AddEventProvider

AddAutoLogger y UpdateAutoLogger

DDInstall