Функция 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
Header memoryapi.h (включая Windows.h)
Библиотека Onecore.lib
DLL Api-ms-win-core-memory-l1-1-4.dll

См. также раздел

Getlasterror

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION