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 |