Skip to main content
Describes the blend state for a render target.

Syntax

Members

BlendEnable
Type: BOOL
Specifies whether to enable (or disable) blending. Set to TRUE to enable blending.
It’s not valid for LogicOpEnable and BlendEnable to both be TRUE.
LogicOpEnable
Type: BOOL
Specifies whether to enable (or disable) a logical operation. Set to TRUE to enable a logical operation.
It’s not valid for LogicOpEnable and BlendEnable to both be TRUE.
SrcBlend
Type: D3D12_BLEND
A D3D12_BLEND-typed value that specifies the operation to perform on the RGB value that the pixel shader outputs. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. DestBlend
Type: D3D12_BLEND
A D3D12_BLEND-typed value that specifies the operation to perform on the current RGB value in the render target. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. BlendOp
Type: D3D12_BLEND_OP
A D3D12_BLEND_OP-typed value that defines how to combine the SrcBlend and DestBlend operations. SrcBlendAlpha
Type: D3D12_BLEND
A D3D12_BLEND-typed value that specifies the operation to perform on the alpha value that the pixel shader outputs. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. DestBlendAlpha
Type: D3D12_BLEND
A D3D12_BLEND-typed value that specifies the operation to perform on the current alpha value in the render target. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. BlendOpAlpha
Type: D3D12_BLEND_OP
A D3D12_BLEND_OP-typed value that defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. LogicOp
Type: D3D12_LOGIC_OP
A D3D12_LOGIC_OP-typed value that specifies the logical operation to configure for the render target. RenderTargetWriteMask
Type: UINT8
A combination of D3D12_COLOR_WRITE_ENABLE-typed values that are combined by using a bitwise OR operation. The resulting value specifies a write mask.

Remarks

It’s not valid for LogicOpEnable and BlendEnable to both be TRUE.
You specify an array of D3D12_RENDER_TARGET_BLEND_DESC structures in the RenderTarget member of the D3D12_BLEND_DESC structure to describe the blend states for render targets; you can bind up to eight render targets to the output-merger stage at one time. For info about how blending is done, see the output-merger stage. Here are the default values for blend state.
StateDefault Value
BlendEnableFALSE
LogicOpEnableFALSE
SrcBlendD3D12_BLEND_ONE
DestBlendD3D12_BLEND_ZERO
BlendOpD3D12_BLEND_OP_ADD
SrcBlendAlphaD3D12_BLEND_ONE
DestBlendAlphaD3D12_BLEND_ZERO
BlendOpAlphaD3D12_BLEND_OP_ADD
LogicOpD3D12_LOGIC_OP_NOOP
RenderTargetWriteMaskD3D12_COLOR_WRITE_ENABLE_ALL

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

Core Structures
Last modified on August 20, 2026