> ## 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 dans lesquelles des écritures ont été effectuées 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 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\_<br />Type : PVOID

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

*dwRegionSize*   \_In\_<br />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)<br />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\_<br />Type : ULONG\_PTR\*

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

*lpdwGranularity*   \_Out\_opt\_<br />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](https://learn.microsoft.com/windows/win32/api/memoryapi/nf-memoryapi-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 de `ERROR_CAN_NOT_COMPLETE` par XMemGetWriteWatch.  Cette valeur continuera d'être retournée par XMemGetWriteWatch jusqu'à ce qu'un appel soit effectué à [XMemResumeWriteWatch](/fr-CA/reference/system/xmem/functions/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.

## 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-CA/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)