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

[アーティクル]
02/27/2024

[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 のサポート」を参照してください。