ZwQueryInformationResourceManager ルーチンは、指定された リソース マネージャー オブジェクトに関する情報を取得します。
構文
__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationResourceManager(
[in] HANDLE ResourceManagerHandle,
[in] RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass,
[out] PVOID ResourceManagerInformation,
[in] ULONG ResourceManagerInformationLength,
[out, optional] PULONG ReturnLength
);
パラメーター
[in] ResourceManagerHandle
ZwCreateResourceManager または ZwOpenResourceManager 以前の呼び出しによって取得されたリソース マネージャー オブジェクトへのハンドル。 ハンドルには、オブジェクトへのRESOURCEMANAGER_QUERY_INFORMATIONアクセス権が必要です。
[in] ResourceManagerInformationClass
取得する情報を指定する RESOURCEMANAGER_INFORMATION_CLASS型指定された値。 この値は ResourceManagerBasicInformation する必要があります。
[out] ResourceManagerInformation
ZwQueryInformationResourceManager から情報受け取る呼び出し元によって割り当てられた RESOURCEMANAGER_BASIC_INFORMATION 構造体へのポインター。
[in] ResourceManagerInformationLength
ResourceManagerInformation パラメーターが指すバッファーの長さ (バイト単位)。
[out, optional] ReturnLength
KTM が ResourceManagerInformation バッファーに書き込む情報の長さをバイト単位で受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、NULL できます。
戻り値
ZwQueryInformationResourceManager 、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、このルーチンは次のいずれかの値を返す可能性があります。
| リターン コード | 形容 |
|---|---|
|
指定されたハンドルは、リソース マネージャー オブジェクトへのハンドルではありません。 |
|
オブジェクト ハンドルが無効です。 |
|
ResourceManagerInformationClass パラメーターの値が無効です。 |
|
ResourceManagerInformationLength パラメーターが指定するバッファー サイズは、RESOURCEMANAGER_BASIC_INFORMATION構造体よりも小さいです。 |
|
ResourceManagerInformationLength パラメーターが指定するバッファー サイズが小さすぎて、使用可能なすべての可変長情報を受信できません。 |
|
呼び出し元には、リソース マネージャー オブジェクトへの適切なアクセス権がありません。 |
ルーチンは、他NTSTATUS 値を返す場合があります。
備考
ZwQueryInformationResourceManager ルーチンの詳細については、「Resource Managerの作成」を参照してください。
NtQueryInformationResourceManager と ZwQueryInformationResourceManager は、同じ Windows ネイティブ システム サービス ルーチンの 2 つのバージョンです。
カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx と ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt および Zw バージョンの使用 を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のオペレーティング システム バージョンで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDIs、PowerIrpDDis |
関連項目
RESOURCEMANAGER_BASIC_INFORMATION
RESOURCEMANAGER_INFORMATION_CLASS