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 Drivers 中支援 WMI。
例子
下列程式代碼範例會取得 WPP 追蹤工作階段事件記錄器句柄。
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfwmi.h （包括 Wdf.h） |
| 連結庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <=DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |