QueryVirtualMemoryInformation 函式 (memoryapi.h)

  • 發行項

QueryVirtualMemoryInformation 函式會傳回指定進程虛擬位址空間內頁面或一組頁面的相關信息。

語法

BOOL QueryVirtualMemoryInformation(
  [in]            HANDLE                         Process,
  [in]            const VOID                     *VirtualAddress,
  [in]            WIN32_MEMORY_INFORMATION_CLASS MemoryInformationClass,
  [out]           PVOID                          MemoryInformation,
  [in]            SIZE_T                         MemoryInformationSize,
  [out, optional] PSIZE_T                        ReturnSize
);

參數

[in] Process

要查詢之頁面所在的進程句柄。

[in] VirtualAddress

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

[in] MemoryInformationClass

要擷取資訊的記憶體信息類別。 唯一支援的值是 MemoryRegionInfo。

[out] MemoryInformation

接收指定信息的緩衝區指標。

如果 MemoryInformationClass 參數的值為 MemoryRegionInfo，此參數必須指向 WIN32_MEMORY_REGION_INFORMATION 結構。

[in] MemoryInformationSize

指定記憶體資訊緩衝區的位元組長度。

[out, optional] ReturnSize

選擇性指標，如果指定，則會接收放在記憶體資訊緩衝區中的位元元組數目。

傳回值

成功時傳回 TRUE 。 傳回 FALSE 表示失敗。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果 MemoryInformationClass 參數的值為 MemoryRegionInfo，MemoryInformation 參數必須指向WIN32_MEMORY_REGION_INFORMATION結構。 VirtualAddress 參數必須指向有效記憶體配置內的位址。 如果 VirtualAddress 參數指向未配置的記憶體區域，則函式會失敗。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1607 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 memoryapi.h (包含 Windows.h)
程式庫 Onecore.lib
Dll Api-ms-win-core-memory-l1-1-4.dll

另請參閱

GetLastError

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION