ワーク グラフ

この記事では、D3D12 ワーク グラフをサポートするためにユーザーモード グラフィックス ドライバー (UMD) 用に追加される DDI について説明します。 ワーク グラフ機能は、Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。 ワーク グラフの詳細については、「D3D12 ワーク グラフ」をご覧ください。

ワーク グラフのサポートの報告

次のインターフェイスは、UMD に対して更新または導入され、ワーク グラフのサポートを報告します。

• D3D12DDICAPS_TYPE_OPTIONS_0109 機能による報告エントリが、PFND3D12DDI_GETCAPS によって使用される D3D12DDICAPS_TYPE 列挙型に追加されます。

• この上限エントリは、ドライバーがサポートするワーク グラフのサポートのレベルを示す WorkGraphsTier メンバーを持つ D3D12DDI_OPTIONS_DATA_0103 上限構造体に対応します。

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 サブオブジェクトの型 (および関連する状態オブジェクト作成構造体) には、ワーク グラフとの関連性があります。

Definition	列挙値	関連する構造体
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 仕様からそのまま継承されます。