XMemGetWriteWatch
Récupère l’adresse des pages dans lesquelles des écritures ont été effectuées dans une plage d’adresses virtuelles.Syntaxe
Paramètres
dwFlags _In_Type : DWORD Indique si l’état de suivi des écritures est réinitialisé après l’appel à XMemGetWriteWatch. Spécifiez
WRITE_WATCH_FLAG_RESET pour signaler que le suivi des écritures doit être réinitialisé. Sinon, spécifiez 0.
lpBaseAddress _In_Type : PVOID L’adresse de base de la plage pour laquelle récupérer les informations de suivi des écritures. dwRegionSize _In_
Type : SIZE_T La taille de la plage pour laquelle récupérer les informations de suivi des écritures. lpAddresses _Out_writes_to_opt_(*lpdwCount,*lpdwCount)
Type : PVOID Un pointeur vers une mémoire tampon qui reçoit un tableau des adresses des pages dans lesquelles des écritures ont été effectuées pour la plage d’adresses. lpdwCount _Inout_opt_
Type : ULONG_PTR* En entrée, fournit le nombre d’éléments du tableau dans lpAddresses.
En sortie, contient le nombre d’éléments du tableau retournés. lpdwGranularity _Out_opt_
Type : LPDWORD Un pointeur vers une variable qui reçoit la taille de page, en octets.
Valeur de retour
Type : UINT En cas de réussite, XMemGetWriteWatch retourne 0. Si la fonction échoue, la valeur de retour est différente de zéro.Remarques
XMemGetWriteWatch est essentiellement semblable à GetWriteWatch en fonctionnement normal. Cependant, comme les captures GPU de PIX nécessitent également le suivi des écritures, XMemGetWriteWatch a un comportement supplémentaire lorsque des captures GPU de PIX se produisent. Lorsqu’une capture GPU de PIX se produit, le suivi des écritures est suspendu pour le titre. Cela est indiqué par le retour deERROR_CAN_NOT_COMPLETE par XMemGetWriteWatch. Cette valeur continuera d’être retournée par XMemGetWriteWatch jusqu’à ce qu’un appel soit effectué à XMemResumeWriteWatch (une fois la capture GPU terminée) pour indiquer que l’appelant est prêt à reprendre le suivi des écritures. L’état de suivi des écritures est inconnu pour toutes les plages d’adresses virtuelles MEM_WRITE_WATCH après la fin d’une capture GPU de PIX. Il incombe à l’appelant de rétablir une attente de référence de l’état de suivi des écritures de chaque plage surveillée. Cela peut se faire en appelant XMemResetWriteWatch, XMemGetWriteWatch avec WRITE_WATCH_FLAG_RESET ou en écrivant intentionnellement dans les régions MEM_WRITE_WATCH.