Fonction ResetWriteWatch (memoryapi.h)

  • Article

Réinitialise l’état de suivi des écritures pour une région de mémoire virtuelle. Les appels suivants à la fonction GetWriteWatch rapportent uniquement les pages écrites dans depuis l’opération de réinitialisation.

Windows 64 bits sur les systèmes Itanium : En raison de la différence de taille de page, ResetWriteWatch n’est pas pris en charge pour les applications 32 bits.

Syntaxe

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

Paramètres

[in] lpBaseAddress

Pointeur vers l’adresse de base de la région de mémoire pour laquelle réinitialiser l’état de suivi des écritures.

Cette adresse doit se trouver dans une région de mémoire allouée par la fonction VirtualAlloc avec MEM_WRITE_WATCH.

[in] dwRegionSize

Taille de la région de mémoire pour laquelle réinitialiser les informations de suivi des écritures, en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est 0 (zéro).

Si la fonction échoue, la valeur de retour est une valeur différente de zéro.

Notes

La fonction ResetWriteWatch peut être utile pour une application telle qu’un récupérateur de mémoire. L’application appelle la fonction GetWriteWatch pour récupérer la liste des pages écrites, puis écrit dans ces pages dans le cadre de son opération de nettoyage. Ensuite, le récupérateur de mémoire appelle ResetWriteWatch pour supprimer les enregistrements de suivi des écritures provoqués par le nettoyage.

Vous pouvez également réinitialiser l’état de suivi des écritures d’une région de mémoire en spécifiant WRITE_WATCH_FLAG_RESET lorsque vous appelez GetWriteWatch.

Si vous utilisez ResetWriteWatch, vous devez vous assurer qu’aucun thread n’écrit dans la région pendant l’intervalle entre les appels GetWriteWatch et ResetWriteWatch . Sinon, il peut y avoir des pages écrites que vous ne détectez pas.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête memoryapi.h (inclure Windows.h, Memoryapi.h)
Bibliothèque onecore.lib
DLL Kernel32.dll

Voir aussi

GetWriteWatch

Fonctions de gestion de la mémoire

VirtualAlloc