Función ResetWriteWatch (memoryapi.h)

Restablece el estado de seguimiento de escritura para una región de memoria virtual. Las llamadas posteriores a la función GetWriteWatch solo notifican páginas que se escriben en desde la operación de restablecimiento.

Windows de 64 bits en sistemas basados en Itanium: Debido a la diferencia en los tamaños de página, ResetWriteWatch no es compatible con las aplicaciones de 32 bits.

Sintaxis

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

Parámetros

[in] lpBaseAddress

Puntero a la dirección base de la región de memoria para la que se restablece el estado de seguimiento de escritura.

Esta dirección debe estar en una región de memoria asignada por la función VirtualAlloc con MEM_WRITE_WATCH.

[in] dwRegionSize

Tamaño de la región de memoria para la que se restablece la información de seguimiento de escritura, en bytes.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es 0 (cero).

Si se produce un error en la función, el valor devuelto es un valor distinto de cero.

Comentarios

La función ResetWriteWatch puede ser útil para una aplicación como un recolector de elementos no utilizados. La aplicación llama a la función GetWriteWatch para recuperar la lista de páginas escritas y, a continuación, escribe en esas páginas como parte de su operación de limpieza. A continuación, el recolector de elementos no utilizados llama a ResetWriteWatch para quitar los registros de seguimiento de escritura causados por la limpieza.

También puede restablecer el estado de seguimiento de escritura de una región de memoria especificando WRITE_WATCH_FLAG_RESET al llamar a GetWriteWatch.

Si usa ResetWriteWatch, debe asegurarse de que ningún subproceso escriba en la región durante el intervalo entre las llamadas GetWriteWatch y ResetWriteWatch . De lo contrario, puede haber páginas escritas que no detecte.

Requisitos

Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	memoryapi.h (incluya Windows.h, Memoryapi.h)
Library	onecore.lib
Archivo DLL	Kernel32.dll

Vea también

GetWriteWatch

Funciones de administración de memoria

VirtualAlloc