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)

另請參閱

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate