次の方法で共有


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

[KMDF にのみ適用]

ドライバーの EvtWmiInstanceSetItem コールバック関数は、WMI データ プロバイダーのインスタンス データの 1 つの項目を WMI クライアントが提供する値に設定します。

構文

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

NTSTATUS EvtWdfWmiInstanceSetItem(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG DataItemId,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

パラメーター

[in] WmiInstance

WMI インスタンス オブジェクトへのハンドル。

[in] DataItemId

プロバイダー インスタンスのデータ項目を識別する 値。 この値は、プロバイダーの MOF ファイルで指定された WmiDataId 値に対応します。

[in] InBufferSize

InBuffer が指す入力バッファーのサイズ (バイト単位)。

[in] InBuffer

入力バッファーへのポインター。

戻り値

操作が成功した場合、 EvtWmiInstanceSetItem コールバック関数はSTATUS_SUCCESSを返す必要があります。 それ以外の場合、この関数は、NT_SUCCESS(status) が FALSE である状態値を返す必要があります。 InBuffer パラメーターが指す入力バッファーが小さすぎて、ドライバーが予期するすべてのデータを含めすぎる場合、コールバック関数は STATUS_WMI_SET_FAILUREを返す必要があります。

注釈

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

フレームワークは、ドライバーの WMI イベント コールバック関数の呼び出しを相互に同期したり、ドライバーの他のイベント コールバック関数と同期したりすることはありません。 EvtWmiInstanceSetItem コールバック関数のデータが動的で、他のコールバック関数と共有されている場合、ドライバーはフレームワークの待機ロックまたはスピン ロックを使用してデータへのアクセスを同期できます。

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

要件

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

こちらもご覧ください

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate