Skip to main content

PIXBeginRetailEvent

启动一个用户定义的零售事件。

语法

参数

context   
类型:void*
事件的上下文,接受 ID3D12GraphicsCommandList\*ID3D12GraphicsCommandList\*ID3D12XboxDmaCommandList\*(仅限 XBOX)。 color   
类型:UINT64
在系统计时图表中使用的事件颜色。使用 PIX_COLOR 指定颜色,使用 PIX_COLOR_INDEX 指定颜色索引,或传入原始 DWORD,请注意其格式为 ARGB,Alpha 通道值必须为 0xff。
formatString   _In_
类型:PCWSTR
用于描述事件的名称,作为指向以 null 结尾 Unicode 字符串的指针。该字符串可以指定零个或多个可选的字符串格式占位符,非常类似于 sprintf 格式。 类型:… 如果在 formatString 中使用了占位符,则必须有相应数量的参数,其类型取决于占位符。此方法最多支持 16 个格式参数。

返回值

类型:void

备注

在调试或检测设备上,PIXBeginRetailEvent 的行为与 PIXBeginEvent 完全相同。对于零售设备,这些事件将包含在用于 GPU 挂起调试的 HIX 文件中。 PIXBeginRetailEventPIXEndRetailEvent 对可以嵌套到任意深度。

要求

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

另请参阅

PIX(NDA 主题)
pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, …)
最后修改于 2026年8月24日