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

# XMemResetWriteWatch

> XMemResetWriteWatch

# XMemResetWriteWatch

重設虛擬記憶體區域的寫入追蹤狀態

## 語法

```cpp theme={null}
UINT WINAPI XMemResetWriteWatch(
  PVOID lpBaseAddress,
  SIZE_T dwRegionSize
)
```

### 參數

*lpBaseAddress*   \_In\_<br />類型：PVOID

要重設寫入追蹤狀態之記憶體區域的基底位址

*dwRegionSize*   \_In\_<br />類型：SIZE\_T

要重設寫入追蹤狀態之記憶體區域的大小。

### 傳回值

類型：UINT

成功時，XMemResetWriteWatch 會傳回 0。如果函式失敗，傳回值為非零值。

### 備註

在正常運作時，XMemResetWriteWatch 與 [ResetWriteWatch](https://learn.microsoft.com/windows/win32/api/memoryapi/nf-memoryapi-resetwritewatch) 大致相同。不過，因為 PIX GPU 擷取也需要寫入追蹤，所以發生 PIX GPU 擷取時，XMemResetWriteWatch 會有額外的行為。

發生 PIX GPU 擷取時，遊戲的寫入追蹤會暫停。這會由 XMemGetWriteWatch 傳回 `ERROR_CAN_NOT_COMPLETE` 來表示。XMemGetWriteWatch 會持續傳回此值，直到 (GPU 擷取完成後) 呼叫 [XMemResumeWriteWatch](/zh-TW/reference/system/xmem/functions/xmemresumewritewatch)，表示呼叫端已準備好繼續寫入追蹤為止。PIX GPU 擷取完成後，所有 `MEM_WRITE_WATCH` 虛擬位址範圍的寫入追蹤狀態都是未知的。呼叫端有責任為每個受監視的範圍重新建立寫入追蹤狀態的基準預期。這可以透過呼叫 XMemResetWriteWatch、使用 `WRITE_WATCH_FLAG_RESET` 呼叫 XMemGetWriteWatch，或刻意寫入 MEM\_WRITE\_WATCH 區域來完成。

## 需求

**標頭：** xmem.h

**程式庫：** xmem.lib

**支援的平台**：XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[xmem 成員](/zh-TW/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)
- [XPackageWriteStats](/reference/system/xpackage/structs/xpackagewritestats.md)