Função ResetWriteWatch (memoryapi.h)

  • Artigo

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

Confira também

GetWriteWatch

Funções de gerenciamento da memória

Virtualalloc