> ## 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

Recupera o endereço das páginas que foram gravadas em um intervalo de endereços virtuais.

## Sintaxe

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

### Parâmetros

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

Indica se o estado de rastreamento de gravação é redefinido após a chamada para XMemGetWriteWatch.  Especifique `WRITE_WATCH_FLAG_RESET` para sinalizar que o rastreamento de gravação deve ser redefinido.  Caso contrário, especifique 0.

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

O endereço base do intervalo para o qual as informações de rastreamento de gravação serão recuperadas.

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

O tamanho do intervalo para o qual as informações de rastreamento de gravação serão recuperadas.

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

Um ponteiro para um buffer que recebe uma matriz dos endereços das páginas gravadas no intervalo de endereços.

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

Na entrada, fornece a contagem de elementos da matriz em *lpAddresses*.<br /> Na saída, contém o número de elementos da matriz retornados.

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

Um ponteiro para uma variável que recebe o tamanho da página, em bytes.

### Valor retornado

Tipo: UINT

Em caso de êxito, XMemGetWriteWatch retorna 0. Se a função falhar, o valor retornado será diferente de zero.

### Comentários

XMemGetWriteWatch é substancialmente semelhante a [GetWriteWatch](https://learn.microsoft.com/windows/win32/api/memoryapi/nf-memoryapi-getwritewatch) na operação normal.  No entanto, como as capturas de GPU do PIX também exigem rastreamento de gravação, XMemGetWriteWatch tem um comportamento adicional quando ocorrem capturas de GPU do PIX.

Quando ocorre uma captura de GPU do PIX, o rastreamento de gravação é suspenso para o título.  Isso é indicado pelo retorno de `ERROR_CAN_NOT_COMPLETE` por XMemGetWriteWatch.  Esse valor continuará sendo retornado por XMemGetWriteWatch até que seja feita uma chamada para [XMemResumeWriteWatch](/pt-BR/reference/system/xmem/functions/xmemresumewritewatch) (após a conclusão da captura de GPU) indicando que o chamador está pronto para retomar o rastreamento de gravação.  O estado de rastreamento de gravação é desconhecido para todos os intervalos de endereços virtuais `MEM_WRITE_WATCH` após a conclusão de uma captura de GPU do PIX.  É responsabilidade do chamador restabelecer uma expectativa de linha de base do estado de rastreamento de gravação de cada intervalo que está sendo monitorado.  Isso pode ser feito chamando XMemResetWriteWatch, XMemGetWriteWatch com `WRITE_WATCH_FLAG_RESET` ou gravando intencionalmente nas regiões MEM\_WRITE\_WATCH.

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas com suporte**: consoles da família XBOX One e consoles XBOX Series

## Confira também

[xmem](/pt-BR/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)