Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ID3D11Device1::CreateBlendState1 method

Creates a blend-state object that encapsulates blend state for the output-merger stage and allows the configuration of logic operations.

Syntax


HRESULT CreateBlendState1(
  [in]            const D3D11_BLEND_DESC1 *pBlendStateDesc,
  [out, optional]       ID3D11BlendState1 **ppBlendState
);

Parameters

pBlendStateDesc [in]

A pointer to a D3D11_BLEND_DESC1 structure that describes blend state.

ppBlendState [out, optional]

Address of a pointer to the ID3D11BlendState1 interface for the blend-state object created.

Return value

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

The logical operations (those that enable bitwise logical operations between pixel shader output and render target contents, refer to D3D11_RENDER_TARGET_BLEND_DESC1 ) are only available on certain feature levels; call CheckFeatureSupport with D3D11_FEATURE_D3D11_OPTIONS set, to ensure support by checking the boolean field OutputMergerLogicOp of D3D11_FEATURE_DATA_D3D11_OPTIONS.

An app 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

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

D3D11_1.h

Library

D3D11.lib

See also

ID3D11Device1

 

 

Community Additions

ADD
Show:
© 2015 Microsoft