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型指定された値。
戻り値
WdfWmiProviderIsEnabled は、ProviderControl パラメーターで指定されている機能が有効で、それ以外の場合は FALSE 場合、TRUE を返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
備考
EvtWmiProviderFunctionControl コールバック関数を提供しないドライバーは、WdfWmiProviderIsEnabled を呼び出して、データ収集またはイベント通知が有効になっているかどうかを判断できます。
例
次のコード例では、指定した WMI データ プロバイダーに対してイベント通知が有効になっているかどうかを判断します。
BOOLEAN eventNotifEnabled;
eventNotifEnabled = WdfWmiProviderIsEnabled(
wmiProvider,
WdfWmiEventControl
);
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfwmi.h (Wdf.h を含む) |
| ライブラリ | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
関連項目
EvtWmiProviderFunctionControl の
WdfWmiInstanceGetProvider の
WdfWmiProviderCreate の