EVT_WDF_WMI_INSTANCE_SET_INSTANCE コールバック関数 (wdfwmi.h)
[KMDF にのみ適用]
ドライバーの EvtWmiInstanceSetInstance コールバック関数は、WMI データ プロバイダーのすべてのインスタンス データを WMI クライアントが提供する値に設定します。
構文
EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;
NTSTATUS EvtWdfWmiInstanceSetInstance(
[in] WDFWMIINSTANCE WmiInstance,
[in] ULONG InBufferSize,
[in] PVOID InBuffer
)
{...}
パラメーター
[in] WmiInstance
WMI インスタンス オブジェクトへのハンドル。
[in] InBufferSize
InBuffer が指す入力バッファーのサイズ (バイト単位)。
[in] InBuffer
入力バッファーへのポインター。
戻り値
操作が成功した場合、 EvtWmiInstanceSetInstance コールバック関数はSTATUS_SUCCESSを返す必要があります。 それ以外の場合、この関数は、NT_SUCCESS(status) が FALSE である状態値を返す必要があります。 InBuffer パラメーターが指す入力バッファーが小さすぎて、ドライバーが予期するすべてのデータを含めすぎる場合、コールバック関数は STATUS_WMI_SET_FAILUREを返す必要があります。
注釈
EvtWmiInstanceSetInstance コールバック関数を登録するには、ドライバーが WdfWmiInstanceCreate を呼び出す前に、関数のアドレスを WDF_WMI_INSTANCE_CONFIG 構造体に配置する必要があります。
フレームワークは、ドライバーの WMI イベント コールバック関数の呼び出しを相互に同期したり、ドライバーの他のイベント コールバック関数と同期したりすることはありません。 EvtWmiInstanceSetInstance コールバック関数のデータが動的であり、他のコールバック関数と共有されている場合、ドライバーはフレームワークの待機ロックまたはスピン ロックを使用してデータへのアクセスを同期できます。
EvtWmiInstanceSetInstance コールバック関数の詳細については、「Framework-Based ドライバーでの WMI のサポート」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.0 |
Header | wdfwmi.h (Wdf.h を含む) |
IRQL | PASSIVE_LEVEL |