次の方法で共有

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
ヘッダー wdfwmi.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 を する DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

関連項目

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider の

WdfWmiProviderCreate の