INF DDInstall.Events セクション

各モデルごとの DDInstall.Events セクションには、INF ファイル内の追加の INF ライター定義セクションを参照する 1 つ以上の INF AddEventProvider ディレクティブ、 AddAutoLogger または UpdateAutoLogger が含まれています。 このセクションは、Windows 10 バージョン 1809 以降でサポートされています。

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

Event Tracing for Windows (ETW) プロバイダを登録するために、 DDInstall.Events セクションに少なくとも一つの AddEventProvider ディレクティブを指定することができます。 また、 AddAutoLogger ディレクティブを1つ以上指定して、 AutoLogger セッションを設定して開始する および UpdateAutoLogger ディレクティブを指定して、既存のAutoLoggerセッションにAutoLoggerプロバイダーを追加することもできます。

エントリ

AddEventProvider={ProviderGUID},event-provider-install-section
このディレクティブは、この DDInstall セクションの対象となるデバイスのドライバーのINFファイルの他の場所でINFライタで定義された event-provider-install-section を参照します。 詳細については、 「INF AddEventProvider ディレクティブ」を参照してください。

AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
このディレクティブは、この DDInstall セクションの対象となるデバイスのドライバーのINFファイルの他の場所でINFライタで定義された add-autologger-install-section を参照します。 詳細については、 INF AddAutoLogger および UpdateAutoLogger ディレクティブを参照してください。

UpdateAutoLogger=session-name,update-autologger-install-section
このディレクティブは、この DDInstall セクションの対象となるデバイスのドライバーのINFファイルの他の場所でINFライタで定義された aupdate-autologger-install-section を参照します。 詳細については、 INF AddAutoLogger および UpdateAutoLogger ディレクティブを参照してください。

Include=filename.inf[,filename2.inf]...
この省略可能なエントリは、このデバイス クラスをインストールするために必要なセクションを含む 1 つ以上のシステム提供の名前付き INF ファイルを指定します。 このエントリが指定されている場合、 通常は Needs エントリも必要です。

Needs=inf-section-name[,inf-section-name]...
この省略可能なエントリは、このデバイス クラスのインストール中に処理する必要があるセクションを指定します。 通常、このセクションは DDInstall.Events セクションであり、 Include エントリーにリストされているシステム提供のINFファイル内にあります。 ただし、 DDInstall.Events セクション内で参照されるセクションであれば、どのセクションでもかまいません。

解説

DDInstall.Events セクションは、関連する DDInstall セクションと同じプラットフォームとオペレーティング・システムの装飾が必要です。 例えば、 install-section-name.ntx86 セクションは、対応する install-section-name.ntx86.Events セクションを持つことになります。

指定された DDInstall セクションは、INF ファイルの製造元ごとの Models セクションのデバイス/モデル固有のエントリで参照する必要があります。 正式な構文文に示されている install-section-name の大文字小文字を区別しない拡張は、クロスプラットフォームINFファイルの DDInstall.Events セクション名に挿入することができます。

システム定義の .nt, .ntx86, .ntia64, .ntamd64, .ntarm, および .ntarm64 の拡張機能の使用方法の詳細については、「複数のプラットフォームとオペレーティング システム用の INF ファイルの作成」を参照してください。

例

この例では、INFファイルの install-section-name.Events セクションとそのevent-provider-install-sections、add-autologger-install-sections、update-autologger-install-sectionsを示しています。

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

関連項目

AddEventProvider

AddAutoLogger と UpdateAutoLogger

DDInstall