ReclaimVirtualMemory 関数 (memoryapi.h)

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 アプリ]
サポートされている最小のサーバー	Windows Server 2012 R2 Update [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	memoryapi.h (Windows.h、Memoryapi.h を含む)
Library	onecore.lib
[DLL]	Kernel32.dll

関連項目

メモリ管理関数

OfferVirtualMemory

仮想メモリ関数

VirtualAlloc

VirtualFree

VirtualLock

VirtualQuery