Skip to content

Latest commit

 

History

History
83 lines (62 loc) · 3.34 KB

ne-d3d12umddi-d3d12ddi_render_pass_beginning_access_type_0053.md

File metadata and controls

83 lines (62 loc) · 3.34 KB
Raw
UID title description ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.max-support req.typenames targetos tech.root ms.custom f1_keywords topic_type api_type api_location api_name dev_langs
NE:d3d12umddi.D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053
D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053 (d3d12umddi.h)
The call to begin a render pass uses the D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053 enumeration to specify the type of resource access.
10/19/2018
D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053 enumeration
D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053, D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053,
d3d12umddi.h
Windows 10, version 1809
D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053
Windows
display
RS5
D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053
d3d12umddi/D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053
apiref
HeaderDef
d3d12umddi.h
D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053
c++

D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053 enumeration

-description

Declares the type of resource access for the call to PFND3D12DDI_BEGIN_RENDER_PASS_0053.

-enum-fields

-field D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_DISCARD

Indicates that the application does not have any dependency on the prior contents of the resource.

A given implementation may return the previously-written contents, or it may return uninitialized data. However, reading from the resource must not produce a GPU hang, and the 'read' may only return undefined data in the worst case. A read is defined as a traditional:

  • UAV (Unordered Access View)
  • SRV (Shader Resource View)
  • CBV (Constant Buffer View)
  • VBV (Vertex Buffer View)
  • IBV (Index Buffer View)
  • IndirectArg binding/read
  • blend/depth-testing-induced read

-field D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_PRESERVE

Indicates that the application has a dependency on the prior contents of the resource, and the contents must be loaded from main memory.

-field D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_CLEAR

Indicates that the application has a dependency on the resource being cleared to a specific (app-provided) color.

Note

This clear occurs whether or not the resource has interacted with anything beyond the Render Pass.

The API will allow the application to specify the clear values in the call to PFND3D12DDI_BEGIN_RENDER_PASS_0053, via the D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_CLEAR_PARAMETERS_0053 structure.

-field D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_NO_ACCESS

Indicates that the resource will not be read from or written to during the Render Pass. This value also indicates whether the depth/stencil plane for a DSV (Data Source View) was not accessed.

Important

This value must be paired with the D3D12DDI_RENDER_PASS_ENDING_ACCESS_NO_ACCESS value in D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0053.

-remarks

-see-also