D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053 enumeration (d3d12umddi.h)

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

Syntax

typedef enum D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053 {
  D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_DISCARD,
  D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_PRESERVE,
  D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_CLEAR,
  D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_NO_ACCESS
} ;

Constants

 
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
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.
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.

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.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809
Header d3d12umddi.h