IHostMemoryManager::VirtualQuery 메서드

해당 Win32 함수에 대한 논리적 래퍼 역할을 합니다. VirtualQuery의 Win32 구현은 호출 프로세스의 가상 주소 공간에서 페이지 범위에 대한 정보를 검색합니다.

구문

HRESULT VirtualQuery (  
    [in]  void*    lpAddress,  
    [out] void*    lpBuffer,  
    [in]  SIZE_T   dwLength,  
    [out] SIZE_T*  pResult  
);  

매개 변수

lpAddress
[in] 쿼리할 가상 메모리의 주소에 대한 포인터입니다.

lpBuffer
[out] 지정된 메모리 영역에 대한 정보를 포함하는 구조체에 대한 포인터입니다.

dwLength
[in] lpBuffer가 가리키는 버퍼의 크기(바이트)입니다.

pResult
[out] 정보 버퍼에서 반환된 바이트 수에 대한 포인터입니다.

Return Value

HRESULT	설명
S_OK	VirtualQuery가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태에 있습니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED	차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 더 이상 프로세스 내에서 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.

설명

VirtualQuery는 호출 프로세스의 가상 주소 공간에 있는 페이지 범위에 대한 정보를 제공합니다. 이 구현에서는 pResult 매개 변수 값을 정보 버퍼에 반환된 바이트 수로 설정하고 HRESULT 값을 반환합니다. Win32 VirtualQuery 함수에서 반환 값은 버퍼 크기입니다. 자세한 내용은 Windows 플랫폼 설명서를 참조하세요.

중요

운영 체제의 VirtualQuery 구현은 교착 상태를 발생시키지 않으며 사용자 코드에서 일시 중단된 임의의 스레드를 사용하여 완료될 때까지 실행할 수 있습니다. 이 메서드의 호스트된 버전을 구현할 때는 주의해야 합니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목

• IHostMemoryManager 인터페이스