D3DPERF_BeginEvent 函数

标记用户定义的事件的开头。 PIX 可以使用此事件来触发操作。

语法

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

col

事件颜色。这是在事件视图中显示事件的颜色。

wszName

事件名称。

此事件从零开始的层次结构级别。如果发生错误，则返回值为负。

用户定义的事件以对目标程序有意义的方式将其他事件组合在一起，以便可以在性能分析工具中更好地表示它们。例如， Draw Spaceship 事件可能会将处理在游戏中绘制宇宙飞船的多个 Direct3D 调用括起来。事件可以嵌套。

每个 D3DPERF_BeginEvent 调用都应具有匹配 D3DPERF_EndEvent 调用。应使用 D3DPERF_SetMarker 而不是使用D3DPERF_BeginEvent和D3DPERF_EndEvent来标记没有括号的即时事件 () 。