共用方式為


INF DDInstall.Events 區段

每個模型 DDInstallEvents 區 段包含一或多個 INF AddEventProvider 指示詞、 AddAutoLoggerUpdateAutoLogger ,這些指示詞會參考 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=filenameinf[,filename2.inf]...
這個選擇性專案會指定一或多個額外的系統提供的 INF 檔案,其中包含安裝此裝置所需的區段。 如果指定此專案,則通常也需要 [需要 ] 專案。

Needs=inf-section-name[,inf-section-name]...
這個選擇性專案會指定在安裝此裝置期間必須處理的區段。 一般而言,區段是 DDInstall。系統提供 INF 檔案中的事件 區段,該檔案列在 Include 專案中。 不過,它可以是 DDInstall 中參考的任何區段。事件區 段。

備註

DDInstall事件 區段應該具有與其相關 DDInstall 區段相同的平臺和操作系統裝飾。 例如 ,install-section-namentx86 區段會有對應的 install-section-namentx86。事件區 段。

指定的 DDInstall 區段必須參考 INF 檔案中每個製造商 模型 區段下的裝置/模型特定專案。 在正式語法語句中顯示的 install-section-name 不區分大小寫的延伸模組可以插入這類 DDInstall 中。跨平臺 INF 檔案中的事件 區段名稱。

如需如何使用系統定義的 .nt.ntx86、.ntia64.ntamd64、.ntarm.ntarm64 延伸模組的詳細資訊,請參閱建立多個平臺和操作系統的 INF 檔案

範例

此範例顯示 install-section-nameEvents 區 段及其 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] 
; ... 

另請參閱

AddEventProvider

AddAutoLogger 和 UpdateAutoLogger

DDInstall