> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XMemGetWriteWatch

> XMemGetWriteWatch

# XMemGetWriteWatch

Récupère l'adresse des pages qui ont fait l'objet d'écritures dans une plage d'adresses virtuelles.

## Syntaxe

```cpp theme={null}
UINT XMemGetWriteWatch(  
         DWORD dwFlags,  
         PVOID lpBaseAddress,  
         SIZE_T dwRegionSize,  
         PVOID* lpAddresses,  
         ULONG_PTR* lpdwCount,  
         LPDWORD lpdwGranularity  
)  
```

### Paramètres

*dwFlags*   \_In\_<br />Type : DWORD

Indique si l'état du suivi des écritures est réinitialisé après l'appel à XMemGetWriteWatch.  Spécifiez `WRITE_WATCH_FLAG_RESET` pour indiquer que le suivi des écritures doit être réinitialisé.  Sinon, spécifiez 0.

*lpBaseAddress*   \_In\_<br />Type : PVOID

Adresse de base de la plage pour laquelle récupérer les informations de suivi des écritures.

*dwRegionSize*   \_In\_<br />Type : SIZE\_T

Taille de la plage pour laquelle récupérer les informations de suivi des écritures.

*lpAddresses*   \_Out\_writes\_to\_opt\_(\*lpdwCount,\*lpdwCount)<br />Type : PVOID

Pointeur vers une mémoire tampon qui reçoit un tableau des adresses des pages ayant fait l'objet d'écritures pour la plage d'adresses.

*lpdwCount*   \_Inout\_opt\_<br />Type : ULONG\_PTR\*

En entrée, fournit le nombre d'éléments du tableau *lpAddresses*.<br /> En sortie, contient le nombre d'éléments de tableau renvoyés.

*lpdwGranularity*   \_Out\_opt\_<br />Type : LPDWORD

Pointeur vers une variable qui reçoit la taille de page, en octets.

### Valeur renvoyée

Type : UINT

En cas de réussite, XMemGetWriteWatch renvoie 0. Si la fonction échoue, la valeur renvoyée est différente de zéro.

### Remarques

En fonctionnement normal, XMemGetWriteWatch est très similaire à [GetWriteWatch](https://learn.microsoft.com/windows/win32/api/memoryapi/nf-memoryapi-getwritewatch).  Toutefois, comme les captures GPU PIX nécessitent également le suivi des écritures, XMemGetWriteWatch présente un comportement supplémentaire lorsque des captures GPU PIX se produisent.

Lorsqu'une capture GPU PIX se produit, le suivi des écritures est suspendu pour le titre.  Cela est signalé par le renvoi de `ERROR_CAN_NOT_COMPLETE` par XMemGetWriteWatch.  Cette valeur continue d'être renvoyée par XMemGetWriteWatch jusqu'à ce qu'un appel à [XMemResumeWriteWatch](/fr/reference/system/xmem/functions/xmemresumewritewatch) soit effectué (une fois la capture GPU terminée) pour indiquer que l'appelant est prêt à reprendre le suivi des écritures.  L'état du suivi des écritures est inconnu pour toutes les plages d'adresses virtuelles `MEM_WRITE_WATCH` une fois qu'une capture GPU PIX est terminée.  Il incombe à l'appelant de rétablir une référence de base attendue pour l'état du suivi des écritures de chaque plage surveillée.  Pour ce faire, vous pouvez appeler XMemResetWriteWatch, appeler XMemGetWriteWatch avec `WRITE_WATCH_FLAG_RESET` ou écrire intentionnellement dans les régions MEM\_WRITE\_WATCH.

## Configuration requise

**En-tête :** xmem.h

**Bibliothèque :** xmem.lib

**Plateformes prises en charge** : consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[xmem](/fr/reference/system/xmem/xmem_members)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)
- [D3D12_FEATURE_DATA_ARCHITECTURE1](/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public.md)
- [Troubleshooting XBOX services sign-in](/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)