WdfWmiProviderIsEnabled 関数 (wdfwmi.h)

[KMDF にのみ適用]

WdfWmiProviderIsEnabled メソッドは、指定された WMI データ プロバイダーに対してデータ収集またはイベント通知が有効になっているかどうかを判断します。

構文

BOOLEAN WdfWmiProviderIsEnabled(
  [in] WDFWMIPROVIDER           WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL ProviderControl
);

パラメーター

[in] WmiProvider

ドライバーが WdfWmiProviderCreate または WdfWmiInstanceGetProvider を呼び出して取得する WMI プロバイダー オブジェクトへのハンドル。

[in] ProviderControl

WMI データ プロバイダーがサポートできるコントロール関数の種類 (データ収集またはイベント通知) の 1 つを指定するWDF_WMI_PROVIDER_CONTROL型指定された値。

戻り値

ProviderControl パラメーターで指定されている機能が有効で、それ以外の場合は FALSE の場合、WdfWmiProviderIsEnabled は TRUE を返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

EvtWmiProviderFunctionControl コールバック関数を提供しないドライバーは、WdfWmiProviderIsEnabled を呼び出して、データ収集またはイベント通知が有効になっているかどうかを判断できます。

例

次のコード例では、指定した WMI データ プロバイダーに対してイベント通知が有効になっているかどうかを判断します。

BOOLEAN eventNotifEnabled;

eventNotifEnabled = WdfWmiProviderIsEnabled(
                                            wmiProvider,
                                            WdfWmiEventControl
                                            );

要件

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

こちらもご覧ください

EvtWmiProviderFunctionControl

WDF_WMI_PROVIDER_CONTROL

WdfWmiInstanceGetProvider

WdfWmiProviderCreate