PIXBeginRetailEvent 函数
启动一个用户定义的零售事件。语法
参数
context类型:void* 事件的上下文,接受
ID3D12GraphicsCommandList\*、ID3D12GraphicsCommandList\* 和 ID3D12XboxDmaCommandList\*(仅限 XBOX)。
color 类型:UINT64 在系统计时图表中使用的事件颜色。使用 PIX_COLOR 指定颜色,使用 PIX_COLOR_INDEX 指定颜色索引,或传入原始 DWORD,请注意其格式为 ARGB,Alpha 通道值必须为 0xff。
formatString _In_
类型:PCSTR 用于描述事件的名称,作为指向以 null 结尾字符串的指针。该字符串可以指定零个或多个可选的字符串格式占位符,非常类似于
sprintf 格式。
类型:…
如果在 formatString 中使用了占位符,则必须有相应数量的参数,其类型取决于占位符。此方法最多支持 16 个格式参数。
返回值
类型:void备注
在调试或检测设备上,PIXBeginRetailEvent 的行为与 PIXBeginEvent 完全相同。对于零售设备,这些事件将包含在用于 GPU 挂起调试的 HIX 文件中。
PIXBeginRetailEvent 和 PIXEndRetailEvent 对可以嵌套到任意深度。
要求
头文件: pix3.h 库: pixevt.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机另请参阅
PIXBeginRetailEvent(void*,UINT64, PCWSTR, …)PIXEndRetailEvent
pix3
PIX(NDA 主题)
