DiscardVirtualMemory 関数 (memoryapi.h)

メモリをコミットせずに、メモリページの範囲のメモリ内容を破棄します。破棄されたメモリの内容は未定義であり、アプリケーションで書き換える必要があります。

構文

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 Update [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	memoryapi.h (Windows.h、Memoryapi.h を含む)
Library	onecore.lib
[DLL]	Kernel32.dll