Skip to main content

PIXRecordMemoryAllocationEvent

记录一个内存分配事件。

语法

参数

allocatorId
类型:USHORT
一个 ID,你可以使用它在内存分析器中标识内存分配组。例如,如果你有针对图形、音频和物理等不同事项的不同堆,则可以为这些类别中的每一个分配不同的 allocatorID,以便在 PIX 中查看内存捕获时易于识别。 baseAddress
类型:void*
已分配内存的起始地址。 size
类型:size_t
已分配内存的字节大小。 metadata
类型:UINT64
一个 64 位无符号整数,你可以使用它以额外数据来标记分配。这些额外数据在 PIX 中显示在 UserData 列中。例如,你可以使用这些额外数据来识别游戏中在给定内存位置存储的对象类型。

返回值

类型:void

备注

PIX 内存跟踪事件提供 PIX 所需的数据,以便在内存分析捕获中显示有关游戏自定义内存分配器内所有内存分配和释放的信息。通过提供这些数据,PIX 将为你的自定义分配器显示与 VirtualAlloc/VirtualFreeHeapAlloc/HeapFree 调用相同的所有数据。 如果同时发生许多事件或系统处于繁重负载下,则内存事件可能会被 Windows 事件跟踪 (ETW) 丢失。事件丢失将导致数据分析不完整。PIX 内存捕获 UI 将显示指示事件丢失的警告。 可以使用多个 PIXRecordMemoryFreeEvent 调用来跟踪从单个分配中逐步释放的内存。 有关自定义分配和释放数据如何在内存捕获中显示的信息,请参阅 PIX 自定义内存分配器(NDA 主题)

要求

头文件: pixmemory.h 库: pixevt.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

PIX(NDA 主题) PIX 自定义内存分配器(NDA 主题) PIX API 参考 PIXRecordMemoryFreeEvent
最后修改于 2026年8月24日