PIXSetMarker function
当特定的用户自定义事件发生时，向 PIX System Timing Capture 窗口的 CPU 时间线插入一个标记。语法
参数
color类型：UINT64 在 PIX 窗口中该事件发生时，用于时序图表的颜色。 使用 PIX_COLOR 指定颜色，使用 PIX_COLOR_INDEX 指定颜色索引，或者传入一个原始 DWORD，注意其格式为 ARGB 且 alpha 通道值必须为 0xff。 formatString _In_
类型：PCSTR 用于描述事件的名称。该字符串可以指定零个或多个可选的字符串格式占位符，与
sprintf 的格式化方式非常相似。
类型：…
如果在 formatString 中使用了占位符，则必须提供相应数量（最多 16 个）的参数，且其类型与占位符匹配。
返回值
类型：void备注
PIXSetMarker 函数会保存格式字符串和格式参数，而不是在运行时格式化字符串。格式化操作会在 PIX 中读取捕获文件时完成。使用 PIXSetMarker 时，请使用 16 字节对齐的字符串（首选）或 8 字节对齐的字符串以获得最佳性能。若要使用 %p 格式说明符将 char* 或 wchar_t* 打印为指针，请在将其传递给 PIXSetMarker 时，将该指针强制转换为 void* 或指向整数或浮点类型的指针。对 PIXSetMarker 的任何调用都至少保证 512 字节的空间用于保存记录数据。
该事件将显示为无持续时间，并在 PIX System Timing Capture 窗口中以一条竖线（单个竖条）表示。
此函数用于在 CPU 时间线中标记事件。若要在 GPU 时间线中标记事件，请调用 PIXSetMarker 函数的第三个重载或 PIXSetMarker 函数的第四个重载。
对 PIXSetMarker 的调用可以出现在任何位置，无需在 PIXBeginEvent 调用之后。
要求
头文件： pix3.h 库： pixevt.lib 支持的平台： XBOX One 系列主机和 XBOX Series 主机另请参阅
PIXSetMarker_2PIXSetMarker_3
PIXSetMarker_4
PIX3
PIX (NDA 主题)