ID3D11Device::CreateBlendState Method

Create a blend-state object that encapsules blend state for the output-merger stage.

Syntax

public:
HRESULT CreateBlendState(
         const D3D11_BLEND_DESC *pBlendStateDesc,
         ID3D11BlendState **ppBlendState
)

Parameters

pBlendStateDesc
Type: D3D11_BLEND_DESC *

[in] Pointer to a blend-state description (see D3D11_BLEND_DESC).

ppBlendState
Type: ID3D11BlendState **

[out, optional] Address of a pointer to the blend-state object created (see ID3D11BlendState).

Return value

Type: HRESULT

This method returns E_OUTOFMEMORY if there is insufficient memory to create the blend-state object. See Direct3D 11 return codes for other possible return values.

Remarks

An application can create up to 4096 unique blend-state objects. For each object created, the runtime checks to see if a previous object has the same state. If such a previous object exists, the runtime will return a pointer to previous instance instead of creating a duplicate object.

Requirements

Header: Declared in d3d11_x.h (d3d11.h on other Windows platforms).