DiscardVirtualMemory 함수(memoryapi.h)

아티클
08/24/2023

메모리를 커밋 해제하지 않고 메모리 페이지 범위의 메모리 내용을 삭제합니다. 삭제된 메모리의 내용은 정의되지 않았으며 애플리케이션에서 다시 작성해야 합니다.

구문

DWORD DiscardVirtualMemory(
  [in] PVOID  VirtualAddress,
  [in] SIZE_T Size
);

매개 변수

[in] VirtualAddress

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

[in] Size

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

반환 값

성공하면 ERROR_SUCCESS. 그렇지 않으면 시스템 오류 코드 입니다.

설명

DiscardVirtualMemory가 실패하면 지역의 내용이 변경되지 않습니다.

메모리 영역 자체를 커밋된 상태로 유지하면서 더 이상 필요하지 않은 메모리 콘텐츠를 삭제하려면 이 함수를 사용합니다. 메모리를 삭제하면 실제 RAM이 시스템에 다시 제공될 수 있습니다. 애플리케이션에서 메모리 영역에 다시 액세스하면 지원 RAM이 복원되고 메모리 내용이 정의되지 않습니다.

중요 메모리 보호가 PAGE_READWRITE 않으면 DiscardVirtualMemory 에 대한 호출이 실패합니다.

요구 사항


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