Skip to main content

XMemResetWriteWatch

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

語法

參數

lpBaseAddress _In_
類型:PVOID
要重設寫入追蹤狀態之記憶體區域的基底位址 dwRegionSize _In_
類型:SIZE_T
要重設寫入追蹤狀態之記憶體區域的大小。

傳回值

類型:UINT 成功時,XMemResetWriteWatch 會傳回 0。如果函式失敗,傳回值為非零值。

備註

在正常運作時,XMemResetWriteWatch 與 ResetWriteWatch 大致相同。不過,因為 PIX GPU 擷取也需要寫入追蹤,所以發生 PIX GPU 擷取時,XMemResetWriteWatch 會有額外的行為。 發生 PIX GPU 擷取時,遊戲的寫入追蹤會暫停。這會由 XMemGetWriteWatch 傳回 ERROR_CAN_NOT_COMPLETE 來表示。XMemGetWriteWatch 會持續傳回此值,直到 (GPU 擷取完成後) 呼叫 XMemResumeWriteWatch,表示呼叫端已準備好繼續寫入追蹤為止。PIX GPU 擷取完成後,所有 MEM_WRITE_WATCH 虛擬位址範圍的寫入追蹤狀態都是未知的。呼叫端有責任為每個受監視的範圍重新建立寫入追蹤狀態的基準預期。這可以透過呼叫 XMemResetWriteWatch、使用 WRITE_WATCH_FLAG_RESET 呼叫 XMemGetWriteWatch,或刻意寫入 MEM_WRITE_WATCH 區域來完成。

需求

標頭: xmem.h 程式庫: xmem.lib 支援的平台:XBOX One 系列主機和 XBOX Series 主機

另請參閱

xmem 成員
Last modified on October 6, 2026