图形事件列表

使用 Visual Studio 图形诊断中的图形事件列表，以浏览呈现你的游戏或应用的帧时记录的 Direct3D 事件。

下面是**“图形事件列表”**窗口：

使用事件列表

当你选择事件列表中的某个事件时，它会反映在由其他图形诊断工具显示的信息中；通过结合使用事件列表和这些其他工具，你可以仔细检查呈现问题以确定其原因。 若要了解有关如何通过结合使用事件列表和其他图形诊断工具来解决呈现问题的详细信息，请参阅图形诊断示例。

有效地使用事件列表的功能，对于解决可能包含数以千计的事件的复杂帧很重要。 若要有效地使用事件列表，请选择最适合你的视图、使用搜索以筛选事件列表、通过链接以了解有关与某个事件相关联的 Direct3D 对象的详细信息，并使用箭头按钮在绘图调用之间快速移动。

事件列表视图

事件列表支持两种不同的视图，这两种视图以不同的方式组织图形事件，以便支持你的工作流和首选项。 第一个视图是按层次结构组织事件及其关联状态的绘图调用视图。 第二个视图是在简单列表中按时间顺序组织事件的时间线视图。

• “绘图调用” 视图
  在层次结构中显示捕获的事件及其状态。 层次结构顶层由事件（例如，绘图调用、清除、显示和处理视图的事件）组成。 在事件列表中，你可以展开绘图调用以显示绘图调用时当前所处的设备状态；你可以进一步展开每种状态以显示设置其值的事件。 在此级别上，你还可以看到是否在之前的帧中设置了某个特定状态，或者自从最后一次绘图调用以后，是否对它进行了多次设置。

• “时间线” 视图
  按时间顺序显示每个捕获的事件。 这种组织事件列表的方式与早期版本的 Visual Studio 中使用的方式相同。

更改事件列表视图模式

• 在**“图形事件列表”窗口的事件列表上方，查找“视图”下拉列表，然后选择“时间线”视图或“绘图调用”**视图。

筛选事件

你可以使用“搜索”框（位于**“图形事件列表”**窗口的右上角）来筛选事件列表，以便仅包括其名称包含特定关键字的事件。 你可以指定单个关键字，例如 Vertex（如之前的说明所示），或使用以分号分隔的列表指定多个关键字，例如 Draw;Primitive（与名称中具有 Draw 或 Primitive 的事件相匹配）。 搜索区分空格（例如，VSSet 和 VS Set 就是不同的搜索），因此请仔细设置搜索形式。

在绘图调用之间移动

因为检查 Draw 调用特别重要，所以你可以使用**“转到下一个绘图调用”和“转到上一个绘图调用”按钮（位于“图形事件列表”**窗口的左上角），以在绘图调用之间快速查找和移动。

指向图形对象的链接

若要了解某些图形事件，你可能需要有关事件引用的当前设备状态或 Direct3D 对象的其他信息。 很多事件都提供了指向此信息的链接，你可以通过这些链接获取更多详细信息。

事件种类和事件标记

将显示在事件列表中的事件组织为四个类别：常规事件、绘图事件、用户定义的事件组和用户定义的事件标记。 除了常规事件以外，每个事件都会随指示它所属类别的图标一起显示。

用户定义的事件

用户定义的事件特定于你的应用。 你可以使用它们，将发生在应用中的重要事件和图形事件列表中的事件关联起来。 例如，你可以创建用户定义的事件组来将相关事件（例如，呈现用户界面的事件）组织到组或层次结构中，以便你可以更加轻松地浏览事件列表，或者，你可以在绘制某种对象时创建标记，以便你可以在事件列表中轻松查找其图形事件。

若要在应用中创建组和标记，请使用 Direct3D 提供的 API，它与供其他 Direct3D 调试工具使用的 API 相同。 下表总结了可用于在不同版本的 Direct3D 中创建组和标记的 API。

你可以使用你的 Direct3D 版本支持的任何 API（例如，如果你面向 Direct3D 11.1 API，你可以使用 SetMarker 或 D3DPerf_SetMarker 创建事件标记，但是不可以使用 SetMarkerInt，因为它仅在 Direct3D 11.2 中可用），并且在同一应用中，你甚至可以将支持不同版本 Direct3D 的 API 混合在一起。

请参见

任务

演练：因设备状态而缺少对象