WMI_SET_DATABLOCK_CALLBACK コールバック関数 (wmilib.h)
DpWmiSetDataBlock ルーチンは、データ ブロックの 1 つのインスタンス内のすべてのデータ項目を変更します。 このルーチンは省略可能です。
構文
WMI_SET_DATABLOCK_CALLBACK WmiSetDatablockCallback;
NTSTATUS WmiSetDatablockCallback(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp,
[in] ULONG GuidIndex,
[in] ULONG InstanceIndex,
[in] ULONG BufferSize,
[in] PUCHAR Buffer
)
{...}
パラメーター
[in] DeviceObject
ドライバーの WDM DEVICE_OBJECT 構造体へのポインター。
[in] Irp
IRP へのポインター。
[in] GuidIndex
WmiSystemControl に渡されたWMILIB_CONTEXT構造体でドライバーによって提供される GUID の一覧に、0 から始まるインデックスによってデータ ブロックを指定します。
[in] InstanceIndex
GuidIndex で指定されたブロックに複数のインスタンスがある場合、InstanceIndex はインスタンスを指定します。
[in] BufferSize
Buffer でバッファーのサイズをバイト単位で指定 します。
[in] Buffer
インスタンスの新しい値を含むバッファーへのポインター。
戻り値
DpWmiSetDataBlock は 、STATUS_SUCCESSまたは次のような適切なエラー状態を返します。
ドライバーが要求をすぐに完了できない場合は、STATUS_PENDINGを返すことができます。
注釈
WMI は、ドライバーがIRP_MN_CHANGE_SINGLE_INSTANCE要求に応答して WmiSystemControl を呼び出した後、ドライバーの DpWmiSetDataBlock ルーチンを呼び出します。
ドライバーは、すべての入力引数を検証する役割を担います。 具体的には、ドライバーは次の操作を行う必要があります。
- WMILIB_CONTEXT構造体のGuidCount メンバーに基づいて、GuidIndex 値が 0 から GuidCount-1 の間にあることを確認します。
- ドライバーが、指定されたデータ ブロックに削除のフラグが設定されていないことを確認します。 ドライバーが、WMILIB_CONTEXT構造体に含まれている WMIGUIDREGINFO 構造体にWMIREG_FLAG_REMOVE_GUID フラグを最近 指定した場合、削除が発生する前に、セット要求が到着する可能性があります。
- InstanceIndex 値が、データ ブロックのドライバーでサポートされているインスタンス インデックスの範囲内にあることを確認します。
- Buffer と BufferSize で、データ項目間に存在するパディングを含む有効なサイズのデータ ブロックが記述されていること、およびバッファーの内容がデータ ブロックに対して有効であることを確認します。
- 指定したデータ ブロックが、ドライバーが呼び出し元によって開始された変更を許可するデータ ブロックであることを確認します。 言い換えると、ドライバーは、読み取り専用にすることを意図したデータ ブロックの変更を許可しないようにする必要があります。
ドライバーが DpWmiSetDataBlock ルーチンを実装する場合、ドライバーは、WmiSystemControl に渡すWMILIB_CONTEXT構造体の SetWmiDataBlock メンバーにルーチンのアドレスを配置する必要があります。 ドライバーが DpWmiSetDataBlock ルーチンを実装していない場合は、 SetWmiDataBlock を NULL に設定する必要があります。 後者の場合、WMI は呼び出し元にSTATUS_READ_ONLYを返します。
このルーチンはページング可能です。
このルーチンの実装の詳細については、「 WmiSystemControl を呼び出して WMI IRP を処理する」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wmilib.h (Wmilib.h を含む) |
| IRQL | PASSIVE_LEVELで呼び出されます。 |