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