QueryVirtualMemoryInformation function (memoryapi.h)

Article
10/13/2021

The QueryVirtualMemoryInformation function returns information about a page or a set of pages within the virtual address space of the specified process.

Syntax

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
);

Parameters

[in] Process

A handle for the process in whose context the pages to be queried reside.

[in] VirtualAddress

The address of the region of pages to be queried. This value is rounded down to the next host-page-address boundary.

[in] MemoryInformationClass

The memory information class about which to retrieve information. The only supported value is MemoryRegionInfo.

[out] MemoryInformation

A pointer to a buffer that receives the specified information.

If the MemoryInformationClass parameter has a value of MemoryRegionInfo, this parameter must point to a WIN32_MEMORY_REGION_INFORMATION structure.

[in] MemoryInformationSize

Specifies the length in bytes of the memory information buffer.

[out, optional] ReturnSize

An optional pointer which, if specified, receives the number of bytes placed in the memory information buffer.

Return value

Returns TRUE on success. Returns FALSE for failure. To get extended error information, call GetLastError.

Remarks

If the MemoryInformationClass parameter has a value of MemoryRegionInfo, the MemoryInformation parameter must point to a WIN32_MEMORY_REGION_INFORMATION structure. The VirtualAddress parameter must point to an address within a valid memory allocation. If the VirtualAddress parameter points to an unallocated memory region, the function fails.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1607 [desktop apps only]
Minimum supported server	Windows Server 2016 [desktop apps only]
Target Platform	Windows
Header	memoryapi.h (include Windows.h)
Library	Onecore.lib
DLL	Api-ms-win-core-memory-l1-1-4.dll