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