Função ResetWriteWatch (memoryapi.h)
Redefine o estado de acompanhamento de gravação para uma região de memória virtual. Chamadas subsequentes para a função GetWriteWatch apenas relatam páginas que são gravadas desde a operação de redefinição.
Windows de 64 bits em sistemas baseados em Itanium: Devido à diferença de tamanhos de página, não há suporte para ResetWriteWatch para aplicativos de 32 bits.
Sintaxe
UINT ResetWriteWatch(
[in] LPVOID lpBaseAddress,
[in] SIZE_T dwRegionSize
);
Parâmetros
[in] lpBaseAddress
Um ponteiro para o endereço base da região de memória para a qual redefinir o estado de rastreamento de gravação.
Esse endereço deve estar em uma região de memória alocada pela função VirtualAlloc com MEM_WRITE_WATCH.
[in] dwRegionSize
O tamanho da região de memória para a qual redefinir as informações de rastreamento de gravação, em bytes.
Valor retornado
Se a função for bem-sucedida, o valor retornado será 0 (zero).
Se a função falhar, o valor retornado será um valor diferente de zero.
Comentários
A função ResetWriteWatch pode ser útil para um aplicativo, como um coletor de lixo. O aplicativo chama a função GetWriteWatch para recuperar a lista de páginas escritas e grava nessas páginas como parte de sua operação de limpeza. Em seguida, o coletor de lixo chama ResetWriteWatch para remover os registros de rastreamento de gravação causados pela limpeza.
Você também pode redefinir o estado de rastreamento de gravação de uma região de memória especificando WRITE_WATCH_FLAG_RESET ao chamar GetWriteWatch.
Se você usar ResetWriteWatch, deverá garantir que nenhum thread seja gravado na região durante o intervalo entre as chamadas GetWriteWatch e ResetWriteWatch . Caso contrário, pode haver páginas escritas que você não detecta.
Requisitos
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | memoryapi.h (inclua Windows.h, Memoryapi.h) |
| Biblioteca | onecore.lib |
| DLL | Kernel32.dll |