Fungsi DiscardVirtualMemory (memoryapi.h)

Artikel
08/24/2023

Membuang isi memori dari rentang halaman memori, tanpa menonaktifkan memori. Isi memori yang dibuang tidak terdefinisi dan harus ditulis ulang oleh aplikasi.

Sintaks

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

Parameter

[in] VirtualAddress

Alamat awal memori yang diratakan halaman untuk dibuang.

[in] Size

Ukuran, dalam byte, dari wilayah memori untuk dibuang. Ukuran harus berupa bilangan bulat kelipatan ukuran halaman sistem.

Menampilkan nilai

ERROR_SUCCESS jika berhasil; Kode Kesalahan Sistem jika tidak.

Keterangan

Jika DiscardVirtualMemory gagal, konten wilayah tidak diubah.

Gunakan fungsi ini untuk membuang konten memori yang tidak lagi diperlukan, sambil menjaga wilayah memori itu sendiri berkomitmen. Membuang memori dapat mengembalikan RAM fisik ke sistem. Ketika wilayah memori kembali diakses oleh aplikasi, RAM cadangan dipulihkan, dan konten memori tidak terdefinisi.

Penting Panggilan ke DiscardVirtualMemory akan gagal jika perlindungan memori tidak PAGE_READWRITE.

Persyaratan


Klien minimum yang didukung	Pembaruan Windows 8.1 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Pembaruan Windows Server 2012 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	memoryapi.h (termasuk Windows.h, Memoryapi.h)
Pustaka	onecore.lib
DLL	Kernel32.dll