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 |