PIXRecordMemoryFreeEvent
记录一个内存释放事件。语法
参数
allocatorId类型：USHORT 一个 ID，你可以使用它在内存分析器中标识内存分配组。例如，如果你有针对图形、音频和物理等不同事项的不同堆，则可以为这些类别中的每一个分配不同的 allocatorID，以便在 PIX 中查看内存捕获时易于识别。 baseAddress
类型：void* 已释放内存的起始地址。 size
类型：size_t 已释放内存的字节大小。 metadata
类型：UINT64 一个 64 位无符号整数，你可以使用它以额外数据来标记内存释放。这些额外数据在 PIX 中显示在 UserData 列中。例如，你可以使用这些额外数据来识别游戏中在给定内存位置已释放的对象类型。传递给
PIXRecordMemoryFreeEvent 的值不必与传递给对应的 PIXRecordMemoryAllocationEvent 调用的值匹配。
返回值
类型：void备注
PIX 内存跟踪事件提供 PIX 所需的数据，以便在内存分析捕获中显示有关游戏自定义内存分配器内所有内存分配和释放的信息。通过提供这些数据，PIX 将为你的自定义分配器显示与VirtualAlloc/VirtualFree 和 HeapAlloc/HeapFree 调用相同的所有数据。
PIX 使用 baseAddress 和 size 参数定位相应的分配，方式如下：如果 baseAddress 与传递给对应 PIXRecordMemoryAllocationEvent 调用的 baseAddress 匹配，PIX 将简单地通过比较地址来匹配分配和释放。在这种情况下，可以为 size 参数传递 0。如果 baseAddress 与对应分配中指定的值不同，则 size 参数必须指定为非零值。在这种情况下，PIX 将同时使用 baseAddress 和 size 来查找相应的分配。
如果同时发生大量事件或系统处于繁重负载下，则内存事件可能会被 Windows 事件跟踪 (ETW) 丢失。事件丢失将导致数据分析不完整。PIX 内存捕获 UI 将显示指示事件丢失的警告。
要求
头文件： pixmemory.h 库： pixevt.lib 支持的平台： XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
PIX 自定义内存分配器（NDA 主题） PIX API 参考PIXRecordMemoryAllocationEvent
PIX（NDA 主题）