Seção INF DDInstall.Events
Cada DDInstall por modelo. A seção Eventos contém uma ou mais diretivas INF AddEventProvider, AddAutoLogger ou UpdateAutoLogger que fazem referência a seções adicionais definidas pelo gravador INF em um arquivo INF. Esta seção tem suporte para Windows 10 versão 1809 e 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]...]
Você pode fornecer um DDInstall. Seção eventos com pelo menos uma diretiva AddEventProvider para registrar provedores ETW ( Rastreamento de Eventos para Windows ). Você também pode fornecer uma ou mais diretivas AddAutoLogger para configurar e iniciar uma sessão do AutoLogger e diretivas UpdateAutoLogger para adicionar provedores AutoLogger a uma sessão do AutoLogger existente.
Entradas
AddEventProvider={ProviderGUID},event-provider-install-section
Essa diretiva faz referência a uma seção inf-writer-defined event-provider-install-section em outro lugar no arquivo INF para os drivers dos dispositivos cobertos por esta seção DDInstall . Para obter mais informações, consulte Diretiva INF AddEventProvider.
AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
Essa diretiva faz referência a um inf-writer-defined add-autologger-install-section em outro lugar no arquivo INF para os drivers dos dispositivos cobertos por esta seção DDInstall . Para obter mais informações, consulte Diretivas INF AddAutoLogger e UpdateAutoLogger.
UpdateAutoLogger=session-name,update-autologger-install-section
Essa diretiva faz referência a um INF-writer-defined update-autologger-install-section em outro lugar no arquivo INF para os drivers dos dispositivos cobertos por esta seção DDInstall . Para obter mais informações, consulte Diretivas INF AddAutoLogger e UpdateAutoLogger.
Include=filename. inf[,filename2.inf]...
Essa entrada opcional especifica um ou mais arquivos INF adicionais fornecidos pelo sistema que contêm seções necessárias para instalar esse dispositivo. Se essa entrada for especificada, uma entrada Needs também geralmente será necessária.
Needs=inf-section-name[,inf-section-name]...
Essa entrada opcional especifica a seção que deve ser processada durante a instalação deste dispositivo. Normalmente, a seção é um DDInstall. Seção eventos em um arquivo INF fornecido pelo sistema que está listado em uma entrada Include . No entanto, pode ser qualquer seção referenciada em um DDInstall. Seção Eventos .
Comentários
DDInstall. As seções de eventos devem ter as mesmas decorações de plataforma e sistema operacional que suas seções DDInstall relacionadas. Por exemplo, um install-section-name. A seção ntx86 teria um install-section-name correspondente. ntx86. Seção Eventos .
A seção DDInstall especificada deve ser referenciada em uma entrada específica de dispositivo/modelos na seção Modelos por fabricante do arquivo INF. As extensões que não diferenciam maiúsculas de minúsculas para install-section-name mostradas na instrução de sintaxe formal podem ser inseridas nesse DDInstall. Nome da seção eventos em arquivos INF multiplataforma.
Para obter mais informações sobre como usar as extensões .nt, .ntx86, .ntia64, .ntamd64, .ntarm e .ntarm64 definidas pelo sistema, consulte Criando arquivos INF para várias plataformas e sistemas operacionais.
Exemplos
Este exemplo mostra o install-section-name. Seção eventos e suas seções event-provider-install-sections, add-autologger-install-sections e update-autologger-install-sections no arquivo 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]
; ...