NtQueryVirtualMemory 函式 (ntifs.h)

發行項
02/26/2024

NtQueryVirtualMemory 例程會決定指定進程虛擬位址空間內頁面區域的狀態、保護和類型。

語法

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryVirtualMemory(
  [in]            HANDLE                   ProcessHandle,
  [in, optional]  PVOID                    BaseAddress,
  [in]            MEMORY_INFORMATION_CLASS MemoryInformationClass,
  [out]           PVOID                    MemoryInformation,
  [in]            SIZE_T                   MemoryInformationLength,
  [out, optional] PSIZE_T                  ReturnLength
);

參數

[in] ProcessHandle

處理要查詢頁面所在的進程內容。使用 NtCurrentProcess 宏來指定目前的進程。

[in, optional] BaseAddress

要查詢之頁面區域的基位址。這個值會四捨五入至下一個主機頁面位址界限。

[in] MemoryInformationClass

要擷取資訊的記憶體信息類別。目前唯 一支援的MEMORY_INFORMATION_CLASS 值為 MemoryBasicInformation。

[out] MemoryInformation

接收指定信息的緩衝區指標。緩衝區的格式和內容取決於 MemoryInformationClass 參數中指定的資訊類別。當 MemoryBasicInformation 值傳遞至 MemoryInformationClass 時， MemoryInformation 參數值是 MEMORY_BASIC_INFORMATION 結構。

[in] MemoryInformationLength

指定 MemoryInformation 所指向之緩衝區的長度，以位元組為單位。

[out, optional] ReturnLength

選擇性指標，如果指定，則會接收在 MemoryInformation 緩衝區中放置的位元組數目。

傳回值

如果呼叫成功，則傳回STATUS_SUCCESS。如果呼叫失敗，可能的錯誤碼包括下列各項：

傳回碼	Description
STATUS_ACCESS_DENIED	呼叫端的訪問許可權不足，無法執行要求的動作。
STATUS_ACCESS_VIOLATION	指定的基位址是無效的虛擬位址。
STATUS_INFO_LENGTH_MISMATCH	MemoryInformation 緩衝區大於 MemoryInformationLength。
STATUS_INVALID_INFO_CLASS	指定的 MemoryInformationClass 參數無效。
STATUS_INVALID_PARAMETER	指定的基位址超出可存取位址的範圍。

備註

ZwQueryVirtualMemory 會決定區域內第一頁的狀態，然後從基位址向上掃描進程地址對應中的後續專案，直到掃描整個頁面範圍，或直到遇到一組不相符屬性的頁面為止。區域屬性、具有相符屬性的頁面區域長度，以及傳回適當的狀態值。

如果頁面的整個區域沒有相符的屬性集，則會個別傳回一個位址保留區內的子區域。它們具有相同的 *MemoryInformation.AllocationBase 值，其個別大小會位於 *MemoryInformation.RegionSize 中，而且可以藉由加總所有與特定 *MemoryInformation.AllocationBase 值相關聯的 *MemoryInformation.RegionSize 值來取得位址保留的總大小。

NtQueryVirtualMemory 和 ZwQueryVirtualMemory 是相同 Windows 原生系統服務例程的兩個版本。

對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱使用 Nt 和 Zw 版本的原生系統服務例程。