WdfWmiProviderGetTracingHandle 函式 (wdfwmi.h)
[僅適用於 KMDF]
WdfWmiProviderGetTracingHandle 方法會將句柄傳回 WPP 軟體追蹤會話的事件記錄器。
語法
ULONGLONG WdfWmiProviderGetTracingHandle(
[in] WDFWMIPROVIDER WmiProvider
);
參數
[in] WmiProvider
呼叫 WdfWmiProviderCreate 或 WdfWmiInstanceGetProvider 取得的 WMI 提供者物件的句柄。
傳回值
WdfWmiProviderGetTracingHandle 會傳回事件追蹤記錄器的句柄。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
備註
如果驅動程式在 WMI 提供者物件WDF_WMI_PROVIDER_CONFIG結構的 Flags 成員中設定 WdfWmiProviderTracing 旗標，它可以呼叫 WdfWmiProviderGetTracingHandle，在註冊提供者實例之後取得追蹤句柄。 驅動程式可以使用追蹤句柄做為 WmiTraceMessage 例程的輸入。
如需 WdfWmiProviderGetTracingHandle 方法的詳細資訊，請參閱 支援 WMI 事件追蹤。 如需 WMI 的詳細資訊，請參閱 在 Framework-Based 驅動程式中支援 WMI。
範例
下列程式代碼範例會取得 WPP 追蹤工作階段事件記錄器的句柄。
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfwmi.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |