D3D12DDI_BARRIER_LAYOUT-Enumeration (d3d12umddi.h)
Ein D3D12DDI_BARRIER_LAYOUT-Wert beschreibt die möglichen Layouts, die von D3D12-Unterressourcen in Bezug auf Texturbarrieren verwendet werden. Layouts gelten nur für Texturressourcen.
Syntax
typedef enum D3D12DDI_BARRIER_LAYOUT {
D3D12DDI_BARRIER_LAYOUT_UNDEFINED,
D3D12DDI_BARRIER_LAYOUT_COMMON,
D3D12DDI_BARRIER_LAYOUT_PRESENT,
D3D12DDI_BARRIER_LAYOUT_GENERIC_READ,
D3D12DDI_BARRIER_LAYOUT_RENDER_TARGET,
D3D12DDI_BARRIER_LAYOUT_UNORDERED_ACCESS,
D3D12DDI_BARRIER_LAYOUT_DEPTH_STENCIL_WRITE,
D3D12DDI_BARRIER_LAYOUT_DEPTH_STENCIL_READ,
D3D12DDI_BARRIER_LAYOUT_SHADER_RESOURCE,
D3D12DDI_BARRIER_LAYOUT_COPY_SOURCE,
D3D12DDI_BARRIER_LAYOUT_COPY_DEST,
D3D12DDI_BARRIER_LAYOUT_RESOLVE_SOURCE,
D3D12DDI_BARRIER_LAYOUT_RESOLVE_DEST,
D3D12DDI_BARRIER_LAYOUT_SHADING_RATE_SOURCE,
D3D12DDI_BARRIER_LAYOUT_VIDEO_DECODE_READ,
D3D12DDI_BARRIER_LAYOUT_VIDEO_DECODE_WRITE,
D3D12DDI_BARRIER_LAYOUT_VIDEO_PROCESS_READ,
D3D12DDI_BARRIER_LAYOUT_VIDEO_PROCESS_WRITE,
D3D12DDI_BARRIER_LAYOUT_VIDEO_ENCODE_READ,
D3D12DDI_BARRIER_LAYOUT_VIDEO_ENCODE_WRITE,
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_COMMON,
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_GENERIC_READ,
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_UNORDERED_ACCESS,
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_SHADER_RESOURCE,
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_COPY_SOURCE,
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_COPY_DEST,
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_COMMON,
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_GENERIC_READ,
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_UNORDERED_ACCESS,
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_SHADER_RESOURCE,
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_COPY_SOURCE,
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_COPY_DEST,
D3D12DDI_BARRIER_LAYOUT_VIDEO_QUEUE_COMMON,
D3D12DDI_BARRIER_LAYOUT_LEGACY_DIRECT_QUEUE_GENERIC_READ_COMPUTE_QUEUE_ACCESSIBLE,
D3D12DDI_BARRIER_LAYOUT_LEGACY_COPY_SOURCE,
D3D12DDI_BARRIER_LAYOUT_LEGACY_COPY_DEST,
D3D12DDI_BARRIER_LAYOUT_LEGACY_SHADER_RESOURCE,
D3D12DDI_BARRIER_LAYOUT_LEGACY_PIXEL_SHADER_RESOURCE
} ;
Konstanten
D3D12DDI_BARRIER_LAYOUT_UNDEFINEDBietet Unterstützung für Layoutänderungen von Untergeordneten Ressourcen, bei denen das vorherige Layout irrelevant oder undefiniert ist. In der Regel wird dies für die Befehle "Full-Subresource" oder "Full-Resource Clear", "Discard" und "Copy" verwendet. Ein Layoutübergang, bei dem sowohl LayoutBefore als auch LayoutAfter auf D3D12_BARRIER_LAYOUT_UNDEFINED festgelegt sind, weist auf eine Barriere hin, die nur auf den Arbeitsspeicher zugreift. Viele Lese-/Schreibvorgänge unterstützen D3D12_BARRIER_LAYOUT_COMMON. Insbesondere Kopierbefehle können mithilfe des D3D12_BARRIER_LAYOUT_COMMONoder D3D12_BARRIER_LAYOUT_COPY in Texturen schreiben. Eine Nur-Speicherzugriffsbarriere kann verwendet werden, um Kopiervorgänge in eine Textur zu leeren, ohne das Texturlayout zu ändern. |
D3D12DDI_BARRIER_LAYOUT_COMMONDies ist das Layout, das von D3D12_RESOURCE_STATE_COMMON verwendet wird. Unterressourcen mit diesem Layout sind in jedem Warteschlangentyp lesbar, ohne dass eine Layoutänderung erforderlich ist. Sie können auch als Kopierziel in jedem Warteschlangentyp geschrieben werden. Die Swapchainpräsentation erfordert, dass der Hintergrundpuffer D3D12_BARRIER_LAYOUT_COMMON verwendet. |
D3D12DDI_BARRIER_LAYOUT_PRESENTAlias für D3D12_BARRIER_LAYOUT_COMMON. |
D3D12DDI_BARRIER_LAYOUT_GENERIC_READBietet Unterstützung für alle schreibgeschützten Zugriffe (z. B. SHADER_RESOURCE, COPY_SOURCE). Dieser Wert sollte nur für Texturen verwendet werden, die mehrere gleichzeitige Lesezugriffe erfordern, da dies möglicherweise nicht so optimal ist wie ein spezifisches Leselayout. |
D3D12DDI_BARRIER_LAYOUT_RENDER_TARGETEntspricht dem layout, das von D3D12_RESOURCE_STATE_RENDER_TARGET verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_UNORDERED_ACCESSEntspricht dem layout, das von D3D12_RESOURCE_STATE_UNORDERED_ACCESS verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_DEPTH_STENCIL_WRITEEntspricht dem layout, das von D3D12_RESOURCE_STATE_DEPTH_WRITE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_DEPTH_STENCIL_READEntspricht dem layout, das von D3D12_RESOURCE_STATE_DEPTH_READ verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_SHADER_RESOURCEEntspricht dem Layout, das von D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE und D3D12_RESOURCE_STATE_NON_PIXEL_SHADER_RESOURCE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_COPY_SOURCEEntspricht dem layout, das von D3D12_RESOURCE_STATE_COPY_SOURCE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_COPY_DESTEntspricht dem layout, das von D3D12_RESOURCE_STATE_COPY_DEST verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_RESOLVE_SOURCEEntspricht dem layout, das von D3D12DDI_RESOURCE_STATE_RESOLVE_SOURCE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_RESOLVE_DESTEntspricht dem layout, das von D3D12DDI_RESOURCE_STATE_RESOLVE_DEST verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_SHADING_RATE_SOURCEEntspricht dem layout, das von D3D12DDI_RESOURCE_STATE_0062_SHADING_RATE_SOURCE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_DECODE_READEntspricht dem layout, das von D3D12_RESOURCE_STATE_VIDEO_DECODE_READ verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_DECODE_WRITEEntspricht dem layout, das von D3D12_RESOURCE_STATE_VIDEO_DECODE_WRITE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_PROCESS_READEntspricht dem layout, das von D3D12_RESOURCE_STATE_VIDEO_PROCESS_READ verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_PROCESS_WRITEEntspricht dem layout, das von D3D12_RESOURCE_STATE_VIDEO_PROCESS_WRITE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_ENCODE_READEntspricht dem layout, das von D3D12_RESOURCE_STATE_VIDEO_ENCODE_READ verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_ENCODE_WRITEEntspricht dem layout, das von D3D12_RESOURCE_STATE_VIDEO_ENCODE_WRITE verwendet wird. |
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_COMMONUnterstützt die allgemeine (barrierefreie) Verwendung nur für direkte Warteschlangen. Dieser Wert ist optimaler als der allgemeinere D3D12DDI_BARRIER_LAYOUT_COMMON. Kann nur in Barrieren für direkte Warteschlangen verwendet werden. Beachten Sie, dass dies nicht für Present verwendet werden kann. D3D12_BARRIER_LAYOUT_COMMON (auch als D3D12_BARRIER_LAYOUT_PRESENT bezeichnet) ist weiterhin das erforderliche Layout für Präsentation. |
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_GENERIC_READIdentisch mit D3D12_BARRIER_LAYOUT_GENERIC_READ mit Ausnahme von Optimierungen, die für direkte Warteschlangen spezifisch sind. Kann nur in Barrieren für direkte Warteschlangen verwendet werden. Darüber hinaus bietet D3D12_BARRIER_LAYOUT_DIRECT_QUEUE_GENERIC_READ Unterstützung für schreibgeschützte Tiefe, Quelle mit Schattierungsrate und Auflösen von Quellzugriffen für direkte Warteschlangen. |
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_UNORDERED_ACCESSIdentisch mit D3D12_BARRIER_LAYOUT_UNORDERED_ACCESS mit Ausnahme von Optimierungen, die für direkte Warteschlangen spezifisch sind. Kann nur in Barrieren für direkte Warteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_SHADER_RESOURCEIdentisch mit D3D12_BARRIER_LAYOUT_SHADER_RESOURCE mit Ausnahme von Optimierungen, die für direkte Warteschlangen spezifisch sind. Kann nur in Barrieren für direkte Warteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_COPY_SOURCEIdentisch mit D3D12_BARRIER_LAYOUT_COPY_SOURCE mit Ausnahme von Optimierungen, die für direkte Warteschlangen spezifisch sind. Kann nur in Barrieren für direkte Warteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_DIRECT_QUEUE_COPY_DESTIdentisch mit D3D12_BARRIER_LAYOUT_COPY_DEST mit Ausnahme von Optimierungen, die für direkte Warteschlangen spezifisch sind. Kann nur in Barrieren für direkte Warteschlangen verwendet werden. Kann eine kostspielige und unnötige Dekomprimierung bei einigen Layoutübergängen für Ressourcen mit dem nächsten Zugriff in einer direkten Warteschlange verhindern. |
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_COMMONUnterstützt die allgemeine (barrierefreie) Verwendung nur für Computewarteschlangen. Kann optimaler sein als die allgemeinere D3D12_BARRIER_LAYOUT_COMMON. Kann nur in Barrieren für Computewarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_GENERIC_READIdentisch mit D3D12_BARRIER_LAYOUT_GENERIC_READ mit Ausnahme von Optimierungen, die für Computewarteschlangen spezifisch sind. Kann nur in Barrieren für Computewarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_UNORDERED_ACCESSIdentisch mit D3D12_BARRIER_LAYOUT_UNORDERED_ACCESS mit Ausnahme von Optimierungen, die für Computewarteschlangen spezifisch sind. Kann nur in Barrieren für Computewarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_SHADER_RESOURCEIdentisch mit D3D12_BARRIER_LAYOUT_SHADER_RESOURCE mit Ausnahme von Optimierungen, die für Computewarteschlangen spezifisch sind. Kann nur in Barrieren für Computewarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_COPY_SOURCEIdentisch mit D3D12_BARRIER_LAYOUT_COPY_SOURCE mit Ausnahme von Optimierungen, die für Computewarteschlangen spezifisch sind. Kann nur in Barrieren für Computewarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_COMPUTE_QUEUE_COPY_DESTIdentisch mit D3D12_BARRIER_LAYOUT_COPY_DEST mit Ausnahme von Optimierungen, die für Computewarteschlangen spezifisch sind. Kann nur in Barrieren für Computewarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_VIDEO_QUEUE_COMMONUnterstützt die allgemeine (barrierefreie) Verwendung nur für Videowarteschlangen. Kann optimaler sein als die allgemeinere D3D12_BARRIER_LAYOUT_COMMON. Kann nur in Barrieren in Videowarteschlangen verwendet werden. |
D3D12DDI_BARRIER_LAYOUT_LEGACY_DIRECT_QUEUE_GENERIC_READ_COMPUTE_QUEUE_ACCESSIBLEUnterstützt einen intern übersetzten Legacyressourcenstatus. Diesem Wert werden keine erweiterten Barriere-APIs zugeordnet. |
D3D12DDI_BARRIER_LAYOUT_LEGACY_COPY_SOURCEUnterstützt einen intern übersetzten Legacyressourcenstatus. Diesem Wert werden keine erweiterten Barriere-APIs zugeordnet. |
D3D12DDI_BARRIER_LAYOUT_LEGACY_COPY_DESTUnterstützt einen intern übersetzten Legacyressourcenstatus. Diesem Wert werden keine erweiterten Barriere-APIs zugeordnet. |
D3D12DDI_BARRIER_LAYOUT_LEGACY_SHADER_RESOURCEUnterstützt einen intern übersetzten Legacyressourcenstatus. Diesem Wert werden keine erweiterten Barriere-APIs zugeordnet. |
D3D12DDI_BARRIER_LAYOUT_LEGACY_PIXEL_SHADER_RESOURCEUnterstützt einen intern übersetzten Legacyressourcenstatus. Diesem Wert werden keine erweiterten Barriere-APIs zugeordnet. |
Hinweise
Pufferressourcen verfügen unabhängig vom Zugriffstyp nur über ein lineares Layout.
Ressourcenlayouts müssen mit dem Typ der Warteschlange kompatibel sein, die den Layoutübergang durchführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11 (WDDM 3.0) |
| Kopfzeile | d3d12umddi.h |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für