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);

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfwmi.h (Wdf.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate