Arbeitsdiagramme
In diesem Artikel werden die DDIs beschrieben, die für einen Benutzermodusgrafiktreiber (UMD) hinzugefügt werden, um D3D12-Arbeitsdiagramme zu unterstützen. Das Arbeitsdiagrammfeature ist ab Windows 11, Version 24H2 (WDDM 3.2) verfügbar. Eine ausführliche Erläuterung von Arbeitsdiagrammen finden Sie in der D3D12-Arbeitsdiagrammspezifikation .
Unterstützung von Arbeitsdiagrammen für die Berichterstattung
Die folgenden Schnittstellen werden aktualisiert oder eingeführt, damit eine UMD ihre Unterstützung für Arbeitsdiagramme meldet:
Der D3D12DDICAPS_TYPE_OPTIONS_0109 Der Capability-Reporting-Eintrag D3D12DDICAPS_TYPE verwendeten Enumeration PFND3D12DDI_GETCAPS hinzugefügt.
Dieser Caps-Eintrag entspricht der D3D12DDI_OPTIONS_DATA_0103 Caps-Struktur, deren Element WorkGraphsTier die Arbeitsdiagrammebene angibt, die der Treiber unterstützt.
DDI-Funktionstabellen
Um Arbeitsdiagramme zu unterstützen, muss UMD die folgenden Funktionen implementieren und Zeiger auf diese in den folgenden DDI-Funktionstabellen bereitstellen:
Referenzseiten zu den Dutzenden von Arbeitsdiagrammstrukturen und Aufzählungen, die mit diesen hinzugefügten DDIs verknüpft sind, finden Sie, indem Sie den Links auf den DDI-Referenzseiten folgen.
Mit der Erstellung von DDI-Statusobjekten verbundene Strukturen und Enumerationen
Die folgenden D3D12DDI_STATE_SUBOBJECT_TYPE Subobjekttypen (und ihre zugehörigen Zustandsobjekterstellungsstrukturen) sind für Arbeitsdiagramme relevant.
| Definition | Enumerationswert | Verwandte Struktur |
|---|---|---|
| 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 |
In einer Zustandsobjektdefinition an der DDI sind Arbeitsdiagramme ein Unterobjekt vom Typ D3D12DDI_STATE_SUBOBJECT_TYPE_WORK_GRAPH. Weitere Informationen finden Sie in der D3D12DDI_WORK_GRAPH_DESC_0108-Struktur für das Unterobjektlayout. Verwandte Strukturen und Enumerationen werden aus der Refpage dieser Struktur verknüpft.
Die anderen Unterobjekttypen werden wie in der DXR-Spezifikation geerbt.