ID3D11Device::CreateDepthStencilState method (d3d11.h)

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

Syntax

HRESULT CreateDepthStencilState(
  [in]            const D3D11_DEPTH_STENCIL_DESC *pDepthStencilDesc,
  [out, optional] ID3D11DepthStencilState        **ppDepthStencilState
);

Parameters

[in] pDepthStencilDesc

Type: const D3D11_DEPTH_STENCIL_DESC*

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

[out, optional] 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

See also

ID3D11Device