ID3D10Device::CreateDepthStencilState method (d3d10.h)

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

Syntax

HRESULT CreateDepthStencilState(
  [in]  const D3D10_DEPTH_STENCIL_DESC *pDepthStencilDesc,
  [out] ID3D10DepthStencilState        **ppDepthStencilState
);

Parameters

[in] pDepthStencilDesc

Type: const D3D10_DEPTH_STENCIL_DESC*

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

[out] ppDepthStencilState

Type: ID3D10DepthStencilState**

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

Return value

Type: HRESULT

This method returns one of the following Direct3D 10 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 with the same description as an already existing depth-stencil state, then the same interface with an incremented reference count will be returned and the total number of unique depth-stencil state objects will stay the same.

Requirements

Requirement Value
Target Platform Windows
Header d3d10.h
Library D3D10.lib

See also

ID3D10Device Interface