通过

PIXSetMarker 参考

  • 项目

当发生特定用户定义的事件时，将一个标记插入到 PIX 系统计时捕获窗口的 CPU 时间线中。

语法

void PIXSetMarker(  
         UINT64 color,  
         PCWSTR formatString,  
         ...  
)

参数

color   
类型：UINT64

在 PIX 窗口中发生此事件时将在计时图表中使用的颜色。

使用 PIX_COLOR 指定颜色，使用 PIX_COLOR_INDEX 指定颜色索引，或传递原始 DWORD；请注意，格式为 ARGB，而 alpha 信道值必须为 0xff。

formatString _In_
类型：PCWSTR

要用来描述事件的名称，作为一个指向以 null 结尾的 Unicode 字符串的指针。 此字符串可能指定零个或多个可选字符串格式占位符，非常类似于 sprintf 格式。

类型：...

如果在 formatString 中使用占位符，则必须有相应数量的参数（最多 16 个），参数类型与占位符匹配。

返回值

类型：void

备注

PIXSetMarker 函数保存格式字符串和格式参数，而不是在运行时格式化字符串。 读取 PIX 中的捕获文件时，执行格式化。 将 16 字节对齐的字符串（首选）或 8 字节对齐的字符串用于 PIXSetMarker 以获得最佳性能。 要使用 %p 格式说明符将 char* 或 wchar_t* 作为指针进行打印，当将指针传递到 PIXSetMarker 时，请将其强制转换为 void* 或一个指向整型或浮点类型的指针。 对 PIXSetMarker 的任何调用都要确保至少 512 字节的空间以便保存记录数据。

该事件将显示为没有持续时间，并且将在 PIX 系统计时捕获窗口用单行（单个竖条）表示。

此函数用于在 CPU 时间线中标记事件。 要在 GPU 时间线中标记事件，请调用 PIXSetMarker 函数的第三个重载或 PIXSetMarker 函数的第四个重载

对 PIXSetMarker 的调用可能会出现在任何地方，并且无需遵循对 PIXBeginEvent 的调用。

要求

头文件：pix3.h

库：pixevt.lib

支持的平台：Xbox One 系列主机和 Xbox Series 主机

另请参阅

PIX 概述（NDA 主题）
pix3
PIXSetMarker
PIXSetMarker_3
PIXSetMarker_4