INF DDInstall.Events 區段
每個模型 DDInstall。Events 區 段包含一或多個 INF AddEventProvider 指示詞、 AddAutoLogger 或 UpdateAutoLogger ,這些指示詞會參考 INF 檔案中的其他 INF 寫入器定義區段。 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]...]
您可以提供 DDInstall。具有 至少一個 AddEventProvider 指示詞的事件區段,可註冊 Windows (ETW 的事件 追蹤) 提供者。 您也可以提供一或多個 AddAutoLogger 指示詞來 設定和啟動 AutoLogger 會話 和 UpdateAutoLogger 指示詞,將 AutoLogger 提供者新增至現有的 AutoLogger 會話。
項目
AddEventProvider={ProviderGUID},event-provider-install-section
這個指示詞會參考 INF-writer-defined event-provider-install-section ,而 INF 檔案中位於此 DDInstall 區段所涵蓋裝置驅動程式的位置。 如需詳細資訊,請參閱 INF AddEventProvider 指示詞。
AddAutoLogger=session-name,{SessionGUID},add-autologger-install-section
這個指示詞會參考 INF-writer-defined add-autologger-install-section ,而 INF 檔案中位於此 DDInstall 區段所涵蓋裝置的驅動程式。 如需詳細資訊,請參閱 INF AddAutoLogger 和 UpdateAutoLogger 指示詞。
UpdateAutoLogger=session-name,update-autologger-install-section
這個指示詞會參考 INF-writer-defined update-autologger-install-section ,以取得此 DDInstall 區段所涵蓋裝置驅動程式的 INF 檔案。 如需詳細資訊,請參閱 INF AddAutoLogger 和 UpdateAutoLogger 指示詞。
Include=filename。inf[,filename2.inf]...
這個選擇性專案會指定一或多個額外的系統提供的 INF 檔案,其中包含安裝此裝置所需的區段。 如果指定此專案,則通常也需要 [需要 ] 專案。
Needs=inf-section-name[,inf-section-name]...
這個選擇性專案會指定在安裝此裝置期間必須處理的區段。 一般而言,區段是 DDInstall。系統提供 INF 檔案中的事件 區段,該檔案列在 Include 專案中。 不過,它可以是 DDInstall 中參考的任何區段。事件區 段。
備註
DDInstall。事件 區段應該具有與其相關 DDInstall 區段相同的平臺和操作系統裝飾。 例如 ,install-section-name。ntx86 區段會有對應的 install-section-name。ntx86。事件區 段。
指定的 DDInstall 區段必須參考 INF 檔案中每個製造商 模型 區段下的裝置/模型特定專案。 在正式語法語句中顯示的 install-section-name 不區分大小寫的延伸模組可以插入這類 DDInstall 中。跨平臺 INF 檔案中的事件 區段名稱。
如需如何使用系統定義的 .nt、.ntx86、.ntia64、.ntamd64、.ntarm 和 .ntarm64 延伸模組的詳細資訊,請參閱建立多個平臺和操作系統的 INF 檔案。
範例
此範例顯示 install-section-name。Events 區 段及其 event-provider-install-sections、add-autologger-install-sections 和 INF 檔案中的 update-autologger-install-section。
[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]
; ...