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

擷取虛擬位址範圍中已寫入之頁面的位址。

## 語法

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

### 參數

*dwFlags*   \_In\_<br />類型：DWORD

表示呼叫 XMemGetWriteWatch 之後是否要重設寫入追蹤狀態。指定 `WRITE_WATCH_FLAG_RESET` 表示應重設寫入追蹤。否則請指定 0。

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

要擷取寫入追蹤資訊之範圍的基底位址。

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

要擷取寫入追蹤資訊之範圍的大小。

*lpAddresses*   \_Out\_writes\_to\_opt\_(\*lpdwCount,\*lpdwCount)<br />類型：PVOID

指向緩衝區的指標，該緩衝區會接收位址範圍中已寫入之頁面位址的陣列。

*lpdwCount*   \_Inout\_opt\_<br />類型：ULONG\_PTR\*

輸入時，提供 *lpAddresses* 中的陣列元素計數。<br /> 輸出時，包含傳回的陣列元素數目。

*lpdwGranularity*   \_Out\_opt\_<br />類型：LPDWORD

指向接收頁面大小 (以位元組為單位) 之變數的指標。

### 傳回值

類型：UINT

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

### 備註

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

發生 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

- [PFGroupsListMembershipGetResult](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupslistmembershipgetresult.md)
- [PFGroupsListGroupMembersGetResult](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupslistgroupmembersgetresult.md)
- [PFGroupsListMembershipOpportunitiesGetResult](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupslistmembershipopportunitiesgetresult.md)
- [XPackageGetWriteStats](/zh-TW/reference/system/xpackage/functions/xpackagegetwritestats.md)
- [GetShapeDmaWritePointer](/zh-TW/reference/audio/shapedmacontext/functions/getshapedmawritepointer.md)