工作图

本文描述了为支持 D3D12 工作图而为用户模式图形驱动程序 (UMD) 添加的 DDI。 工作图功能从 Windows 11 版本 24H2 (WDDM 3.2) 开始提供。 有关工作图的详细说明，请参阅 D3D12 工作图规范。

报告工作图支持

为 UMD 更新或引入以下接口，以报告其对工作图的支持：

• D3D12DDICAPS_TYPE_OPTIONS_0109 功能报告条目将添加到 PFND3D12DDI_GETCAPS 使用的 D3D12DDICAPS_TYPE 枚举中。

• 此 caps 条目对应于 D3D12DDI_OPTIONS_DATA_0103 caps 结构，其 WorkGraphsTier 成员指示驱动程序支持的工作图支持级别。

DDI 函数表

为了支持工作图，UMD 必须实现以下函数，并在以下 DDI 函数表中提供指向这些函数的指针：

• D3D12DDI_DEVICE_FUNCS_CORE_0109：

  • pfnGetProgramIdentifier
  • pfnGetWorkGraphMemoryRequirements

• D3D12DDI_COMMAND_LIST_FUNCS_3D_0108：

  • pfnSetProgram
  • pfnDispatchGraph

与这些添加的 DDI 相关联的数十个工作图结构和枚举的参考页可以通过单击 DDI 参考页中的链接来查找。

DDI 状态对象创建相关的结构和枚举

以下 D3D12DDI_STATE_SUBOBJECT_TYPE 子对象类型（及其相关的状态对象创建结构）与工作图相关。

定义	枚举值	相关结构
D3D12DDI_STATE_SUBOBJECT_TYPE_STATE_OBJECT_CONFIG	0	D3D12DDI_STATE_OBJECT_CONFIG_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_GLOBAL_ROOT_SIGNATURE	1	D3D12DDI_GLOBAL_ROOT_SIGNATURE_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_LOCAL_ROOT_SIGNATURE	2	D3D12DDI_LOCAL_ROOT_SIGNATURE_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_NODE_MASK	3	D3D12_NODE_MASK_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_DXIL_LIBRARY	5	D3D12DDI_DXIL_LIBRARY_DESC_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_EXISTING_COLLECTION	6	D3D12DDI_EXISTING_COLLECTION_DESC_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_WORK_GRAPH	13	D3D12DDI_WORK_GRAPH_DESC_0108
D3D12DDI_STATE_SUBOBJECT_TYPE_SHADER_EXPORT_SUMMARY	0x100000	D3D12DDI_FUNCTION_SUMMARY_005

在 DDI 的状态对象定义中，工作图是 D3D12DDI_STATE_SUBOBJECT_TYPE_WORK_GRAPH 类型的子对象。 有关子对象布局，请参阅 D3D12DDI_WORK_GRAPH_DESC_0108 结构。 相关结构和枚举是从此结构的 refpage 链接的。

其他子对象类型按原样继承自 DXR 规范。