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来标记没有括号的即时事件 () 。

要求