ReclaimVirtualMemory 함수(memoryapi.h)

아티클
03/05/2024

OfferVirtualMemory를 사용하여 시스템에 제공된 다양한 메모리 페이지를 회수합니다.

제공된 메모리가 삭제된 경우 메모리 영역의 내용은 정의되지 않으며 애플리케이션에서 다시 작성해야 합니다. 제공된 메모리가 삭제되지 않은 경우 그대로 회수됩니다.

구문

DWORD ReclaimVirtualMemory(
  [in] void const *VirtualAddress,
  [in] SIZE_T     Size
);

매개 변수

[in] VirtualAddress

회수할 메모리의 페이지 맞춤 시작 주소입니다.

[in] Size

회수할 메모리 영역의 크기(바이트)입니다. 크기 는 시스템 페이지 크기의 정수 배수여야 합니다.

반환 값

성공하고 메모리가 그대로 회수되면 ERROR_SUCCESS 반환합니다.

성공했지만 메모리가 삭제되고 애플리케이션에서 다시 작성해야 하는 경우 ERROR_BUSY 반환합니다. 이 경우 메모리 영역의 내용은 정의되지 않습니다.

그렇지 않으면 시스템 오류 코드를 반환합니다.

설명

회수된 메모리 페이지는 애플리케이션에서 사용할 수 있으며 페이징이 발생하는 경우 시스템 페이징 파일에 기록됩니다.

함수가 ERROR_SUCCESS 반환하는 경우 회수된 페이지의 데이터가 유효합니다. 함수가 ERROR_BUSY 반환하는 경우 회수된 페이지의 데이터는 시스템에서 삭제되었으며 더 이상 유효하지 않습니다. 이러한 이유로 애플리케이션이 데이터를 다시 생성할 필요가 없거나 다시 생성할 수 있는 경우에만 메모리를 시스템에 제공해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1 Update [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	R2 업데이트 Windows Server 2012 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	memoryapi.h(Windows.h, Memoryapi.h 포함)
라이브러리	onecore.lib
DLL	Kernel32.dll