ID3D11Device::CreateDepthStencilState method

Create a depth-stencil state object that encapsulates depth-stencil test information for the output-merger stage.

Syntax

HRESULT CreateDepthStencilState(
  const D3D11_DEPTH_STENCIL_DESC *pDepthStencilDesc,
  ID3D11DepthStencilState        **ppDepthStencilState
);

Parameters

pDepthStencilDesc

Type: const D3D11_DEPTH_STENCIL_DESC*

Pointer to a depth-stencil state description (see D3D11_DEPTH_STENCIL_DESC).

ppDepthStencilState

Type: ID3D11DepthStencilState**

Address of a pointer to the depth-stencil state object created (see ID3D11DepthStencilState).

Return Value

Type: HRESULT

This method returns one of the following Direct3D 11 Return Codes.

Remarks

4096 unique depth-stencil state objects can be created on a device at a time.

If an application attempts to create a depth-stencil-state interface with the same state as an existing interface, the same interface will be returned and the total number of unique depth-stencil state objects will stay the same.

Requirements

   
Target Platform Windows
Header d3d11.h
Library D3D11.lib

See Also

ID3D11Device