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