跳轉到主要內容

PIXRecordMemoryAllocationEvent

記錄記憶體配置事件。

語法

參數

allocatorId
類型:USHORT
可用來在記憶體分析工具中識別記憶體配置群組的識別碼。例如,如果您針對圖形、音訊和物理等項目使用不同的堆積,則可以為每個類別指派不同的 allocatorID,以便在 PIX 中檢視記憶體擷取時輕鬆識別。 baseAddress
類型:void*
已配置之記憶體的起始位址。 size
類型:size_t
已配置之記憶體的大小 (以位元組為單位)。 metadata
類型:UINT64
64 位元不帶正負號的整數,可用來以其他資料標記配置。這些額外資料會顯示在 PIX 的 UserData 資料行中。例如,您可以使用這些額外資料來識別遊戲中儲存在指定記憶體位置之物件的類型。

傳回值

類型:void

備註

PIX 記憶體追蹤事件會提供 PIX 所需的資料,以便在記憶體分析擷取中顯示從遊戲自訂記憶體配置器內進行之所有記憶體配置和釋放的相關資訊。提供此資料後,PIX 會為您的自訂配置器顯示與 VirtualAlloc/VirtualFree 和 HeapAlloc/HeapFree 呼叫相同的所有資料。 如果同時發生許多事件,或系統處於高負載狀態,記憶體事件可能會被 Event Tracing for Windows (ETW) 遺失。事件遺失會導致資料分析不完整。PIX 記憶體擷取 UI 會顯示警告,指出發生事件遺失。 可以使用多個 PIXRecordMemoryFreeEvent 呼叫,來追蹤從單一配置逐步釋放的記憶體。 如需自訂配置和釋放的資料如何在記憶體擷取中顯示的相關資訊,請參閱 PIX 自訂記憶體配置器 (NDA 主題)。

需求

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

概念文件

另請參閱

PIX (NDA 主題) PIX 自訂記憶體配置器 (NDA 主題) PIX API 參考 PIXRecordMemoryFreeEvent
最後修改於 2026年10月6日