IoWMIQueryAllDataMultiple 関数 (wdm.h)

  • [アーティクル]

IoWMIQueryAllDataMultiple ルーチンは、WMI クラスのセットのいずれかを実装するすべての WMI データ ブロックを返します。

構文

NTSTATUS IoWMIQueryAllDataMultiple(
  [in]            PVOID  *DataBlockObjectList,
  [in]            ULONG  ObjectCount,
  [in, out]       PULONG InOutBufferSize,
  [out, optional] PVOID  OutBuffer
);

パラメーター

[in] DataBlockObjectList

WMI データ ブロック オブジェクトへのポインターの配列へのポインター。 呼び出し元は、 IoWMIOpenBlock ルーチンを使用して WMI クラスごとにデータ ブロック オブジェクトを開きます。 各オブジェクトは、WMIGUID_QUERYアクセス権を使用して開く必要があります。

[in] ObjectCount

DataBlockObjectList パラメーターで渡される配列内のエントリの数を指定します。

[in, out] InOutBufferSize

OutBuffer パラメーターで渡されるバッファーのサイズを指定するメモリ位置へのポインター。 ルーチンが成功した場合は、メモリの場所を更新して、 OutBuffer に実際に格納されているバイト数を指定します。 STATUS_BUFFER_TOO_SMALLの状態コードでルーチンが失敗した場合、データを返すために必要なバイト数が返されます。

[out, optional] OutBuffer

ルーチンが WMI データを返すバッファーへのポインター。 ルーチンは、返されるデータ ブロックのセットごとに 1 つずつ、可変サイズの WNODE_ALL_DATA 構造体のシーケンスを返します。 各WNODE_ALL_DATA構造体の WnodeHeader.Linkage メンバーには、現在のWNODE_ALL_DATAの先頭から次のWNODE_ALL_DATAの先頭までのオフセットが含まれます。 チェーンの最後のブロックには 、WnodeHeader.Linkage が 0 に設定されています。 OutBuffer は 、非ページ プールから割り当てられたバッファーを指す必要があります。

戻り値

ルーチンは NTSTATUS コードを返します。 可能な戻り値は次のとおりです。

リターン コード 説明
STATUS_SUCCESS
 操作が成功しました。 ルーチンは、 OutBuffer パラメーターによって指されるバッファー内の WMI データを返します。 また、このルーチンは、 InOutBufferSize パラメーターが指すメモリ位置で返されたデータのサイズ (バイト単位) も返します。
STATUS_BUFFER_TOO_SMALL
 OutBuffer パラメーターで呼び出し元によって渡されるバッファーが小さすぎます。 ルーチンは、 InOutBufferSize パラメーターが指すメモリ位置に必要なバッファー サイズを返します。

注釈

IoWMIQueryAllDataMultiple は、指定された WMI クラスをサポートするドライバーを決定し、そのようなすべてのドライバーに IRP_MN_QUERY_ALL_DATA 要求を発行します。

ドライバーが指定された WMI クラスのいずれかを実装していない場合、ルーチンは STATUS_SUCCESS InOutBufferSize パラメーターによって指されるメモリ位置に 0 の値を返します。

1 つの WMI クラスに対してクエリを実行するには、 IoWMIQueryAllData を使用します。

要件

要件 値
サポートされている最小のクライアント Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= APC_LEVEL

こちらもご覧ください

IRP_MN_QUERY_ALL_DATA

IoWMIOpenBlock

IoWMIQueryAllData