Fungsi ResetWriteWatch (memoryapi.h)

Mengatur ulang status pelacakan tulis untuk wilayah memori virtual. Panggilan berikutnya ke fungsi GetWriteWatch hanya melaporkan halaman yang ditulis sejak operasi reset.

Windows 64-bit pada sistem berbasis Itanium: Karena perbedaan ukuran halaman, ResetWriteWatch tidak didukung untuk aplikasi 32-bit.

Sintaks

UINT ResetWriteWatch(
  [in] LPVOID lpBaseAddress,
  [in] SIZE_T dwRegionSize
);

Parameter

[in] lpBaseAddress

Penunjuk ke alamat dasar wilayah memori untuk mengatur ulang status pelacakan tulis.

Alamat ini harus berada di wilayah memori yang dialokasikan oleh fungsi VirtualAlloc dengan MEM_WRITE_WATCH.

[in] dwRegionSize

Ukuran wilayah memori untuk mengatur ulang informasi pelacakan tulis, dalam byte.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah 0 (nol).

Jika fungsi gagal, nilai yang dikembalikan adalah nilai bukan nol.

Keterangan

Fungsi ResetWriteWatch dapat berguna untuk aplikasi seperti pengumpul sampah. Aplikasi ini memanggil fungsi GetWriteWatch untuk mengambil daftar halaman tertulis, lalu menulis ke halaman tersebut sebagai bagian dari operasi pembersihannya. Kemudian pengumpul sampah memanggil ResetWriteWatch untuk menghapus rekaman pelacakan tulis yang disebabkan oleh pembersihan.

Anda juga dapat mengatur ulang status pelacakan tulis wilayah memori dengan menentukan WRITE_WATCH_FLAG_RESET saat Anda memanggil GetWriteWatch.

Jika Anda menggunakan ResetWriteWatch, Anda harus memastikan bahwa tidak ada utas yang menulis ke wilayah selama interval antara panggilan GetWriteWatch dan ResetWriteWatch . Jika tidak, mungkin ada halaman tertulis yang tidak Anda deteksi.

Persyaratan

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

Lihat juga

GetWriteWatch

Fungsi Manajemen Memori

VirtualAlloc