D3D12DDI_BARRIER_SYNC Enumeration (d3d12umddi.h)

Artikel
08/07/2023

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein D3D12DDI_BARRIER_SYNC Wert ist ein bitweiser ODER der folgenden Felder, die den Synchronisierungsbereich der GPU-Arbeit in Bezug auf die Barriere angeben.

Syntax

typedef enum D3D12DDI_BARRIER_SYNC {
  D3D12DDI_BARRIER_SYNC_NONE = 0x0,
  D3D12DDI_BARRIER_SYNC_ALL = 0x1,
  D3D12DDI_BARRIER_SYNC_DRAW = 0x2,
  D3D12DDI_BARRIER_SYNC_INPUT_ASSEMBLER = 0x4,
  D3D12DDI_BARRIER_SYNC_VERTEX_SHADING = 0x8,
  D3D12DDI_BARRIER_SYNC_PIXEL_SHADING = 0x10,
  D3D12DDI_BARRIER_SYNC_DEPTH_STENCIL = 0x20,
  D3D12DDI_BARRIER_SYNC_RENDER_TARGET = 0x40,
  D3D12DDI_BARRIER_SYNC_COMPUTE_SHADING = 0x80,
  D3D12DDI_BARRIER_SYNC_RAYTRACING = 0x100,
  D3D12DDI_BARRIER_SYNC_COPY = 0x200,
  D3D12DDI_BARRIER_SYNC_RESOLVE = 0x400,
  D3D12DDI_BARRIER_SYNC_EXECUTE_INDIRECT = 0x800,
  D3D12DDI_BARRIER_SYNC_PREDICATION = 0x800,
  D3D12DDI_BARRIER_SYNC_ALL_SHADING = 0x1000,
  D3D12DDI_BARRIER_SYNC_NON_PIXEL_SHADING = 0x2000,
  D3D12DDI_BARRIER_SYNC_EMIT_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO = 0x4000,
  D3D12DDI_BARRIER_SYNC_VIDEO_DECODE = 0x100000,
  D3D12DDI_BARRIER_SYNC_VIDEO_PROCESS = 0x200000,
  D3D12DDI_BARRIER_SYNC_VIDEO_ENCODE = 0x400000,
  D3D12DDI_BARRIER_SYNC_BUILD_RAYTRACING_ACCELERATION_STRUCTURE = 0x800000,
  D3D12DDI_BARRIER_SYNC_COPY_RAYTRACING_ACCELERATION_STRUCTURE = 0x1000000,
  D3D12DDI_BARRIER_SYNC_SPLIT = 0x80000000
} ;

Konstanten


`D3D12DDI_BARRIER_SYNC_NONE` Wert: 0x0 Die Synchronisierung ist weder vor noch nach einer Barriere erforderlich. Bei Verwendung muss D3D12DDI_BARRIER_SYNC_NONE der einzige Bitsatz sein. Ein SyncBefore-Wert von D3D12DDI_BARRIER_SYNC_NONE impliziert, dass keine vorherigen Barrieren oder Zugriffe auf die Ressource im gleichen ExecuteCommandLists-Bereich vorgenommen wurden. Ein SyncAfter-Wert von D3D12DDI_BARRIER_SYNC_NONE impliziert, dass nach der Barriere im gleichen ExecuteCommandLists-Bereich nicht auf die entsprechenden Unterressourcen zugegriffen wird. In beiden Fällen muss AccessAfterD3D12DDI_BARRIER_ACCESS_NO_ACCESS werden.
`D3D12DDI_BARRIER_SYNC_ALL` Wert: 0x1 Der SyncBefore-Wertvon D3D12DDI_BARRIER_SYNC_ALL gibt an, dass alle vorherigen Arbeiten abgeschlossen sein müssen, bevor die Barriere ausgeführt wird. Der SyncAfter-Wertvon D3D12DDI_BARRIER_SYNC_ALL gibt an, dass alle nachfolgenden Arbeiten warten müssen, bis die Barriere abgeschlossen ist.
`D3D12DDI_BARRIER_SYNC_DRAW` Wert: 0x2 Dieser Wert ist ein Übergeordneter Bereich für alle Draw-Pipelinephasen. Synchronisieren Sie mit den folgenden GPU-Workloads: * DrawInstanced * DrawIndexedInstanced * SetGraphicsRootDescriptorTable * SetGraphicsRootShaderResource * SetGraphicsRootUnorderedAccessView * SetGraphicsRootConstantBufferView Die SetGraphicsRootXxx-Synchronisierung ist erforderlich, um D3D12DDI_DESCRIPTOR_RANGE_FLAG_0013_DATA_STATIC_WHILE_SET_AT_EXECUTE Deskriptoren zu unterstützen. Der SyncBefore-Wertvon D3D12DDI_BARRIER_SYNC_DRAW gibt an, dass alle vorherigen Draw-Arbeiten abgeschlossen sein müssen, bevor die Barriere ausgeführt wird. Der SyncAfter-Wertvon D3D12DDI_BARRIER_SYNC_DRAW gibt an, dass alle nachfolgenden Draw-Arbeiten warten müssen, bis die Barriere abgeschlossen ist.
`D3D12DDI_BARRIER_SYNC_INPUT_ASSEMBLER` Wert: 0x4 Synchronisieren mit der Ausführung der Eingabeassemierungsphase.
`D3D12DDI_BARRIER_SYNC_VERTEX_SHADING` Wert: 0x8 Synchronisieren Sie mit allen Vertexschattierungsstufen, einschließlich Vertex, Domäne, Rumpf, Tessellation, Geometrie, Verstärkung und Gitterschattierung.
`D3D12DDI_BARRIER_SYNC_PIXEL_SHADING` Wert: 0x10 Synchronisieren mit Pixel-Shaderausführung.
`D3D12DDI_BARRIER_SYNC_DEPTH_STENCIL` Wert: 0x20 Synchronisieren sie mit Tiefen-/Schablonen-Lese-/Schreibvorgängen. Dies umfasst DSV-Zugriffe (Depth-Stencil View) während Draw* und ClearRenderTargetView.
`D3D12DDI_BARRIER_SYNC_RENDER_TARGET` Wert: 0x40 Synchronisieren mit Renderziel-Lese-/Schreibvorgängen. Dies schließt RTV-Schreibvorgänge (Render-Target View) während Draw* und ClearRenderTargetView ein.
`D3D12DDI_BARRIER_SYNC_COMPUTE_SHADING` Wert: 0x80 Synchronisieren Sie mit den folgenden GPU-Workloads: * Versand * SetComputeRootDescriptorTable * SetComputeRootShaderResource * SetComputeRootUnorderedAccessView * SetComputeRootConstantBufferView Die SetComputeRootXxx-Synchronisierung ist erforderlich, um D3D12DDI_DESCRIPTOR_RANGE_FLAG_DATA_STATIC_WHILE_SET_AT_EXECUTION-Deskriptoren zu unterstützen.
`D3D12DDI_BARRIER_SYNC_RAYTRACING` Wert: 0x100 Synchronisieren mit raytracing-Ausführung.
`D3D12DDI_BARRIER_SYNC_COPY` Wert: 0x200 Synchronisieren mit Kopierbefehlen.
`D3D12DDI_BARRIER_SYNC_RESOLVE` Wert: 0x400 Synchronisieren sie mit Resolve-Befehlen.
`D3D12DDI_BARRIER_SYNC_EXECUTE_INDIRECT` Wert: 0x800 Synchronisieren mit ExecuteIndirect-Ausführung.
`D3D12DDI_BARRIER_SYNC_PREDICATION` Wert: 0x800 Synchronisieren mit Prädication-Befehlen. Alias mit D3D12DDI_BARRIER_SYNC_EXECUTE_INDIRECT*.
`D3D12DDI_BARRIER_SYNC_ALL_SHADING` Wert: 0x1000 Synchronisieren sie mit der gesamten Shaderausführung.
`D3D12DDI_BARRIER_SYNC_NON_PIXEL_SHADING` Wert: 0x2000 Synchronisieren mit Shaderausführung mit Ausnahme von Pixelschattierung. Ist aus Gründen der Kompatibilität mit der Legacy-ResourceBarrier-API vorhanden.
`D3D12DDI_BARRIER_SYNC_EMIT_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO` Wert: 0x4000 Synchronisieren sie mit PFND3D12DDI_EMIT_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_0054 Arbeit.
`D3D12DDI_BARRIER_SYNC_VIDEO_DECODE` Wert: 0x100000 Synchronisieren mit Video-Decodierungsausführung.
`D3D12DDI_BARRIER_SYNC_VIDEO_PROCESS` Wert: 0x200000 Synchronisieren sie mit der Videoprozessausführung.
`D3D12DDI_BARRIER_SYNC_VIDEO_ENCODE` Wert: 0x400000 Synchronisieren sie mit der Videocodierungsausführung.
`D3D12DDI_BARRIER_SYNC_BUILD_RAYTRACING_ACCELERATION_STRUCTURE` Wert: 0x800000 Synchronisieren sie mit PFND3D12DDI_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_0054 Arbeit. Für das entsprechende Feld AccessBefore oder AccessAfter muss das D3D12DDI_BARRIER_ACCESS_RAYTRACING_ACCELERATION_STRUCTURE_WRITE Bit festgelegt sein.
`D3D12DDI_BARRIER_SYNC_COPY_RAYTRACING_ACCELERATION_STRUCTURE` Wert: 0x1000000 Synchronisieren sie mit PFND3D12DDI_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_0054 Arbeit. Für das entsprechende Feld AccessBefore oder AccessAfter muss das D3D12DDI_BARRIER_ACCESS_RAYTRACING_ACCELERATION_STRUCTURE_WRITE Bit festgelegt sein.
`D3D12DDI_BARRIER_SYNC_SPLIT` Wert: 0x80000000 Spezielles Synchronisierungsbit, das eine geteilte Barriere anzeigt. Wird als SyncAfter-Wert verwendet, um den Beginn einer geteilten Barriere anzugeben. Die Anwendung muss eine übereinstimmende Barriere bereitstellen, wobei SyncBefore auf D3D12DDI_BARRIER_SYNC_SPLIT festgelegt ist. Siehe Hinweise.

Hinweise

Eine geteilte Barriere ist ein Hinweis für den Treiber, dass ein Zustandsübergang zwischen zwei Punkten in einem Befehlsstream erfolgen muss, sogar über ExecuteCommandLists-Grenzen hinweg. Treiber können die erforderlichen Layoutübergänge und Cacheleerungen jederzeit zwischen Beginn und Ende einer split-Barriere abschließen.

Erweiterte Barriere-APIs ermöglichen die SPLIT-Synchronisierung. Geteilte Barrieren werden durch zwei Barrieren dargestellt, bei denen die anfängliche Barriere einen D3D12DDI_BARRIER_SYNC_SPLITSyncAfter-Wert und die endgültige Barriere einen D3D12DDI_BARRIER_SYNC_SPLITSyncBefore-Wert verwendet.

Geteilte Barrierenpaare müssen identische Werte layoutBefore, LayoutAfter, AccessBefore und AccessAfter für die anfänglichen und endgültigen Barrieren verwenden. Geteilte Barrierepaare müssen sequenziell sein, ohne dass andere dazwischen liegende Barrieren für dieselbe Ressource vorhanden sind. Der folgende Codeausschnitt ist ein Beispiel auf Anwendungsebene.

// BEGIN split from compute shader UAV to pixel shader SRV
splitBarrierBegin.SyncBefore = D3D12_BARRIER_SYNC_COMPUTE
splitBarrierBegin.SyncAfter = D3D12_BARRIER_SYNC_SPLIT
splitBarrierBegin.AccessBefore = D3D12_BARRIER_ACCESS_UNORDERED_ACCESS
splitBarrierBegin.AccessAfter = D3D12_BARRIER_ACCESS_DIRECT_QUEUE_SHADER_RESOURCE
splitBarrierBegin.LayoutBefore = D3D12_BARRIER_LAYOUT_UNORDERED_ACCESS
splitBarrierBegin.LayoutAfter = D3D12_BARRIER_LAYOUT_DIRECT_QUEUE_SHADER_RESOURCE

// END split from compute shader UAV to pixel shader SRV
splitBarrierEnd.SyncBefore = D3D12_BARRIER_SYNC_SPLIT
splitBarrierEnd.SyncAfter = D3D12_BARRIER_SYNC_PIXEL_SHADING
splitBarrierEnd.AccessBefore = D3D12_BARRIER_ACCESS_UNORDERED_ACCESS
splitBarrierEnd.AccessAfter = D3D12_BARRIER_ACCESS_DIRECT_QUEUE_SHADER_RESOURCE
splitBarrierEnd.LayoutBefore = D3D12_BARRIER_LAYOUT_UNORDERED_ACCESS
splitBarrierEnd.LayoutAfter = D3D12_BARRIER_LAYOUT_DIRECT_QUEUE_SHADER_RESOURCE

Geteilte Barrieren über ExecuteCommandLists-Grenzen hinweg sind zulässig. In diesem Fall werden alle AccessBefore- und AccessAfter-Werte effektiv ignoriert, da die ExecuteCommandLists-Grenzen alle Cacheleerungen übernehmen. Im Wesentlichen sind cross-ExecuteCommandLists Split Barrieren reine Layoutbarrieren. Daher dient das Aufteilen einer Pufferbarriere oder einer Texturbarriere für gleichzeitigen Zugriff über ExecuteCommandLists-Grenzen nicht. Eine nicht übereinstimmende BEGIN- oder END-Splitbarriere für einen Puffer oder eine Textur mit gleichzeitigem Zugriff in einem bestimmten ExecuteCommandLists-Bereich wird effektiv nicht verwendet, und die Debugebene erzeugt eine Warnung.