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 |