ReclaimVirtualMemory 函式 (memoryapi.h)

使用 OfferVirtualMemory 回收提供給系統的記憶體頁面範圍。

如果已捨棄提供的記憶體，則記憶體區域的內容未定義，而且必須由應用程式重寫。如果未捨棄提供的記憶體，則會完整回收。

語法

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

[in] VirtualAddress

要回收之內存的頁面對齊起始位址。

[in] Size

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

如果成功且記憶體已完整回收，則會傳回ERROR_SUCCESS。

如果成功但已捨棄記憶體，且必須由應用程式重寫，則傳回ERROR_BUSY。在此情況下，記憶體區域的內容未定義。

否則會傳回系統錯誤碼。

應用程式可以使用回收的記憶體頁面，並在發生分頁時寫入系統分頁檔案。

如果函式傳回ERROR_SUCCESS，則回收頁面中的數據有效。如果函式傳回ERROR_BUSY，系統會捨棄回收頁面中的數據，且不再有效。基於這個理由，只有在應用程式不需要或可以重新產生數據時，才會提供記憶體給系統。

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