Fungsi ReclaimVirtualMemory (memoryapi.h)

Artikel
02/28/2024

Merebut kembali berbagai halaman memori yang ditawarkan ke sistem dengan OfferVirtualMemory.

Jika memori yang ditawarkan telah dibuang, konten wilayah memori tidak terdefinisi dan harus ditulis ulang oleh aplikasi. Jika memori yang ditawarkan belum dibuang, memori tersebut akan diklaim kembali secara utuh.

Sintaks

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

Parameter

[in] VirtualAddress

Alamat awal memori yang diratakan halaman untuk diklaim kembali.

[in] Size

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

Nilai kembali

Mengembalikan ERROR_SUCCESS jika berhasil dan memori diklaim kembali secara utuh.

Mengembalikan ERROR_BUSY jika berhasil tetapi memori dibuang dan harus ditulis ulang oleh aplikasi. Dalam hal ini, konten wilayah memori tidak terdefinisi.

Mengembalikan Kode Kesalahan Sistem jika tidak.

Keterangan

Halaman memori yang diklaim kembali dapat digunakan oleh aplikasi, dan akan ditulis ke file halaman sistem jika halaman terjadi.

Jika fungsi mengembalikan ERROR_SUCCESS, data di halaman yang diklaim kembali valid. Jika fungsi mengembalikan ERROR_BUSY, data di halaman yang diklaim kembali dibuang oleh sistem dan tidak lagi valid. Untuk alasan ini, memori hanya boleh ditawarkan ke sistem jika aplikasi tidak membutuhkan atau dapat meregenerasi data.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 Update [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