D3D12_GRAPHICS_PIPELINE_STATE_DESC structure (d3d12.h)

Describes a graphics pipeline state object.

Syntax

typedef struct D3D12_GRAPHICS_PIPELINE_STATE_DESC {
  ID3D12RootSignature                *pRootSignature;
  D3D12_SHADER_BYTECODE              VS;
  D3D12_SHADER_BYTECODE              PS;
  D3D12_SHADER_BYTECODE              DS;
  D3D12_SHADER_BYTECODE              HS;
  D3D12_SHADER_BYTECODE              GS;
  D3D12_STREAM_OUTPUT_DESC           StreamOutput;
  D3D12_BLEND_DESC                   BlendState;
  UINT                               SampleMask;
  D3D12_RASTERIZER_DESC              RasterizerState;
  D3D12_DEPTH_STENCIL_DESC           DepthStencilState;
  D3D12_INPUT_LAYOUT_DESC            InputLayout;
  D3D12_INDEX_BUFFER_STRIP_CUT_VALUE IBStripCutValue;
  D3D12_PRIMITIVE_TOPOLOGY_TYPE      PrimitiveTopologyType;
  UINT                               NumRenderTargets;
  DXGI_FORMAT                        RTVFormats[8];
  DXGI_FORMAT                        DSVFormat;
  DXGI_SAMPLE_DESC                   SampleDesc;
  UINT                               NodeMask;
  D3D12_CACHED_PIPELINE_STATE        CachedPSO;
  D3D12_PIPELINE_STATE_FLAGS         Flags;
} D3D12_GRAPHICS_PIPELINE_STATE_DESC;

Members

pRootSignature

A pointer to the ID3D12RootSignature object.

VS

A D3D12_SHADER_BYTECODE structure that describes the vertex shader.

PS

A D3D12_SHADER_BYTECODE structure that describes the pixel shader.

DS

A D3D12_SHADER_BYTECODE structure that describes the domain shader.

HS

A D3D12_SHADER_BYTECODE structure that describes the hull shader.

GS

A D3D12_SHADER_BYTECODE structure that describes the geometry shader.

StreamOutput

A D3D12_STREAM_OUTPUT_DESC structure that describes a streaming output buffer.

BlendState

A D3D12_BLEND_DESC structure that describes the blend state.

SampleMask

The sample mask for the blend state.

RasterizerState

A D3D12_RASTERIZER_DESC structure that describes the rasterizer state.

DepthStencilState

A D3D12_DEPTH_STENCIL_DESC structure that describes the depth-stencil state.

InputLayout

A D3D12_INPUT_LAYOUT_DESC structure that describes the input-buffer data for the input-assembler stage.

IBStripCutValue

Specifies the properties of the index buffer in a D3D12_INDEX_BUFFER_STRIP_CUT_VALUE structure.

PrimitiveTopologyType

A D3D12_PRIMITIVE_TOPOLOGY_TYPE-typed value for the type of primitive, and ordering of the primitive data.

NumRenderTargets

The number of render target formats in the RTVFormats member.

RTVFormats[8]

An array of DXGI_FORMAT-typed values for the render target formats.

DSVFormat

A DXGI_FORMAT-typed value for the depth-stencil format.

SampleDesc

A DXGI_SAMPLE_DESC structure that specifies multisampling parameters.

NodeMask

For single GPU operation, set this to zero. If there are multiple GPU nodes, set bits to identify the nodes (the device's physical adapters) for which the graphics pipeline state is to apply. Each bit in the mask corresponds to a single node. Refer to Multi-adapter systems.

CachedPSO

A cached pipeline state object, as a D3D12_CACHED_PIPELINE_STATE structure. pCachedBlob and CachedBlobSizeInBytes may be set to NULL and 0 respectively.

Flags

A D3D12_PIPELINE_STATE_FLAGS enumeration constant such as for "tool debug".

Remarks

This structure is used by the CreateGraphicsPipelineState method.

The runtime validates:

• Whether the linkage between the shader stages is correct.
• If the HS and DS members are specified, the PrimitiveTopologyType member for topology type must be set to D3D12_PRIMITIVE_TOPOLOGY_TYPE_PATCH.
• Whether sample frequency execution isn't allowed with the center multi-sample anti-aliasing (MSAA) pattern.
• Whether anti-aliasing lines aren't allowed with the center MSAA pattern.
• If the ForcedSampleCount member of D3D12_RASTERIZER_DESC that RasterizerState specifies isn't zero:
  • Depth/stencil must be disabled.
  • Pixel shader can't output depth.
  • Pixel shader can't run at sample frequency.
  • Render target sample count must be 1.
• Whether blend state is compatible with render target formats.
• Whether pixel shader output type is compatible with render target format.
• Whether the sample count and quality are supported for the render target/depth stencil formats.

Requirements

See also

Conservative Rasterization

Core Structures

Rasterizer Ordered Views