Fonction ResetWriteWatch (memoryapi.h)
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 |