次の方法で共有


EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL コールバック関数 (wdfwmi.h)

[KMDF にのみ適用]

ドライバーの EvtWmiProviderFunctionControl コールバック関数は、指定された WMI データ プロバイダーのデータ収集とイベントの送信に対するドライバーのサポートを有効または無効にします。

構文

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

パラメーター

[in] WmiProvider

WMI プロバイダー オブジェクトへのハンドル。

[in] Control

ドライバー 有効または無効にする必要がある機能を識別するWDF_WMI_PROVIDER_CONTROL型指定された値。

[in] Enable

TRUE の場合、ドライバーが Control で指定する機能を有効にする必要があることを示すブール値。 FALSE の場合、ドライバーは機能を無効にする必要があります。

戻り値

操作が成功した場合、 EvtWmiProviderFunctionControl コールバック関数はSTATUS_SUCCESSを返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE である状態値を返す必要があります。

注釈

EvtWmiProviderFunctionControl コールバック関数を登録するには、ドライバーが WdfWmiProviderCreate を呼び出す前に、関数のアドレスを WDF_WMI_PROVIDER_CONFIG 構造体に配置する必要があります。

ドライバーが WMI データ プロバイダーのWDF_WMI_PROVIDER_CONFIG構造体の Flags メンバーに WdfWmiProviderExpensive フラグを設定し、ドライバーが EvtWmiProviderFunctionControl コールバック関数を提供する場合、ドライバーが WMI データを収集する機能を有効または無効にする必要があるときに、フレームワークはコールバック関数を呼び出します。

EvtWmiProviderFunctionControl コールバック関数を提供する代わりに、ドライバーは WdfWmiProviderIsEnabled を呼び出して、データの収集を有効または無効にする必要があるかどうかを確認できます。

EvtWmiProviderFunctionControl コールバック関数の詳細については、「Framework-Based ドライバーでの WMI のサポート」を参照してください。

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfwmi.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONTROL

WdfWmiProviderCreate

WdfWmiProviderIsEnabled