Edit

Share via

D3D11_RENDER_TARGET_VIEW_DESC1 structure (d3d11_3.h)

  • Article

Describes the subresources from a resource that are accessible using a render-target view.

Syntax

typedef struct D3D11_RENDER_TARGET_VIEW_DESC1 {
  DXGI_FORMAT         Format;
  D3D11_RTV_DIMENSION ViewDimension;
  union {
    D3D11_BUFFER_RTV        Buffer;
    D3D11_TEX1D_RTV         Texture1D;
    D3D11_TEX1D_ARRAY_RTV   Texture1DArray;
    D3D11_TEX2D_RTV1        Texture2D;
    D3D11_TEX2D_ARRAY_RTV1  Texture2DArray;
    D3D11_TEX2DMS_RTV       Texture2DMS;
    D3D11_TEX2DMS_ARRAY_RTV Texture2DMSArray;
    D3D11_TEX3D_RTV         Texture3D;
  };
} D3D11_RENDER_TARGET_VIEW_DESC1;

Members

Format

A DXGI_FORMAT-typed value that specifies the data format.

ViewDimension

A D3D11_RTV_DIMENSION-typed value that specifies the resource type and how the render-target resource will be accessed.

Buffer

A D3D11_BUFFER_RTV structure that specifies which buffer elements can be accessed.

Texture1D

A D3D11_TEX1D_RTV structure that specifies the subresources in a 1D texture that can be accessed.

Texture1DArray

A D3D11_TEX1D_ARRAY_RTV structure that specifies the subresources in a 1D texture array that can be accessed.

Texture2D

A D3D11_TEX2D_RTV1 structure that specifies the subresources in a 2D texture that can be accessed.

Texture2DArray

A D3D11_TEX2D_ARRAY_RTV1 structure that specifies the subresources in a 2D texture array that can be accessed.

Texture2DMS

A D3D11_TEX2DMS_RTV structure that specifies a single subresource because a multisampled 2D texture only contains one subresource.

Texture2DMSArray

A D3D11_TEX2DMS_ARRAY_RTV structure that specifies the subresources in a multisampled 2D texture array that can be accessed.

Texture3D

A D3D11_TEX3D_RTV structure that specifies subresources in a 3D texture that can be accessed.

Remarks

A render-target-view description is passed into ID3D11Device3::CreateRenderTargetView1 to create a render target.

A render-target-view can't use the following formats:

  • Any typeless format.
  • DXGI_FORMAT_R32G32B32 if the view will be used to bind a buffer (vertex, index, constant, or stream-output).
If the format is set to DXGI_FORMAT_UNKNOWN, then the format of the resource that the view binds to the pipeline will be used.

Requirements

Requirement Value
Header d3d11_3.h

See also

Resource Structures