D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101 structure (d3d12umddi.h)

The D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101 structure specifies parameters for preserving a local portion of a resource at the beginning of a render pass.

Syntax

typedef struct D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101 {
  UINT AdditionalWidth;
  UINT AdditionalHeight;
} D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101;

Members

AdditionalWidth

Specifies the additional width, in pixels, to be preserved on either side of the preserved region. A value of 0 means no extra pixels are preserved beyond the specified region. See Remarks.

AdditionalHeight

Specifies the additional height, in pixels, to be preserved above and below the preserved region. A value of 0 means no extra pixels are preserved beyond the specified region. See Remarks.

Remarks

This structure is used when the beginning access Type for a resource within a render pass is one of the following values. For each of these types, the end of the previous pass must specify the matching D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0053_PRESERVE_LOCAL_XXX value and the same AdditionalWidth/AdditionalHeight parameters.

• D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0101_PRESERVE_LOCAL_RENDER

• D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0101_PRESERVE_LOCAL_SRV

• D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0101_PRESERVE_LOCAL_UAV

AdditionalWidth and AdditionalHeight must be set to 0 for D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0101_PRESERVE_LOCAL_RENDER because they don't make sense in the context of rendering.

If AdditionalWidth/AdditionalHeight parameters for the pass are nonzero, they define a border of additional pixel locations around the current one that can also be read. For instance, AdditionalWidth of 1 and AdditionalHeight of 2 means a region 3 pixels wide and 5 pixels tall around the current pixel can be read by the current pixel.

For more information, see D3D12 Render Passes.

Requirements

See also

D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_0053

D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053

D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0053

pfnBeginRenderPass