IoWMIQueryAllData 関数 (wdm.h)
IoWMIQueryAllData ルーチンは、特定の WMI クラスを実装するすべての WMI データ ブロックを返します。
構文
NTSTATUS IoWMIQueryAllData(
[in] PVOID DataBlockObject,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
パラメーター
[in] DataBlockObject
WMI データ ブロック オブジェクトへのポインター。 呼び出し元は、 IoWMIOpenBlock ルーチンを使用して WMI クラスのデータ ブロック オブジェクトを開きます。 オブジェクトは、WMIGUID_QUERYアクセス権を使用して開く必要があります。
[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 コードを返します。 可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
操作が成功しました。 ルーチンは、 OutBuffer パラメーターによって指されるバッファー内の WMI データを返します。 また、このルーチンは、 InOutBufferSize パラメーターが指すメモリ位置で返されたデータのサイズ (バイト単位) も返します。 |
|
ドライバーは、指定された WMI クラスを実装しません。 |
|
OutBuffer パラメーターで呼び出し元によって渡されるバッファーが小さすぎます。 ルーチンは、 InOutBufferSize パラメーターが指すメモリ位置に必要なバッファー サイズを返します。 |
注釈
IoWMIQueryAllData は、指定された WMI クラスをサポートするドライバーを決定し、そのようなすべてのドライバーに IRP_MN_QUERY_ALL_DATA 要求を発行します。
複数の WMI クラスに対してクエリを実行するには、 IoWMIQueryAllDataMultiple を使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |