ID3D11Device::CreateBlendState method (d3d11.h)

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

Syntax

HRESULT CreateBlendState(
  [in]            const D3D11_BLEND_DESC *pBlendStateDesc,
  [out, optional] ID3D11BlendState       **ppBlendState
);

Parameters

[in] pBlendStateDesc

Type: const D3D11_BLEND_DESC*

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

[out, optional] ppBlendState

Type: ID3D11BlendState**

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.

Windows Phone 8: This API is supported.

Requirements

Requirement Value
Target Platform Windows
Header d3d11.h
Library D3D11.lib

See also

ID3D11Device