DiscardVirtualMemory 函式 (memoryapi.h)

捨棄一系列記憶體頁面的記憶體內容，而不需認可記憶體。捨棄記憶體的內容未定義，而且必須由應用程式重寫。

語法

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

[in] VirtualAddress

要捨棄之記憶體的頁面對齊起始位址。

[in] Size

要捨棄的記憶體區域大小，以位元組為單位。 Size 必須是系統頁面大小的整數倍數。

如果成功，ERROR_SUCCESS;否則為系統錯誤碼。

如果 DiscardVirtualMemory 失敗，則不會改變區域的內容。

使用此函式來捨棄不再需要的記憶體內容，同時保留記憶體區域本身。捨棄記憶體可能會讓實體 RAM 回到系統。當應用程式再次存取記憶體區域時，會還原備份 RAM，且未定義記憶體的內容。

重要如果記憶體保護未PAGE_READWRITE，對DiscardVirtualMemory的呼叫將會失敗。


最低支援的用戶端	Windows 8.1更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2012 R2 Update [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	memoryapi.h (包括 Windows.h、Memoryapi.h)
程式庫	onecore.lib
DLL	Kernel32.dll