CreateDepthStencilView(D3D11)
Collapse the table of content
Expand the table of content

CreateDepthStencilView(D3D11) routine

The CreateDepthStencilView(D3D11) function creates a depth-stencil view.

Syntax


PFND3D11DDI_CREATEDEPTHSTENCILVIEW CreateDepthStencilView;

VOID APIENTRY CreateDepthStencilView(
  _In_       D3D10DDI_HDEVICE                   hDevice,
  _In_ const D3D11DDIARG_CREATEDEPTHSTENCILVIEW *pCreateDepthStencilView,
  _In_       D3D10DDI_HDEPTHSTENCILVIEW         hDepthStencilView,
  _In_       D3D10DDI_HRTDEPTHSTENCILVIEW       hRTDepthStencilView
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pCreateDepthStencilView [in]

A pointer to a D3D11DDIARG_CREATEDEPTHSTENCILVIEW structure that describes the parameters that the user-mode display driver uses to create a depth-stencil view.

hDepthStencilView [in]

A handle to the driver's private data for the shader resource view. The driver returns the size, in bytes, of the memory region that the Microsoft Direct3D runtime must allocate for the private data from a call to the driver's CalcPrivateDepthStencilViewSize(D3D11) function. The handle is just a pointer to a region of memory, the size of which the driver requested. The driver uses this region of memory to store internal data structures that are related to its shader resource view object.

hRTDepthStencilView [in]

A handle to the shader resource view that the driver should use when it calls back into the Direct3D runtime.

Return value

None

The driver can use the pfnSetErrorCb callback function to set an error code. For more information about setting error codes, see the following Remarks section.

Remarks

The driver might run out of memory. Therefore, the driver can pass E_OUTOFMEMORY or D3DDDIERR_DEVICEREMOVED in a call to the pfnSetErrorCb function. The Direct3D runtime determines that any other errors are critical. If the driver passes any errors, which includes D3DDDIERR_DEVICEREMOVED, the Direct3D runtime determines that the handle is invalid; therefore, the runtime does not call the DestroyDepthStencilView function to destroy the handle that the hDepthStencilView parameter specifies.

Requirements

Target platform

Version

CreateDepthStencilView(D3D11) is supported beginning with the Windows 7 operating system.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateDepthStencilViewSize(D3D11)
D3D11DDI_DEVICEFUNCS
D3D11DDIARG_CREATEDEPTHSTENCILVIEW
DestroyDepthStencilView
pfnSetErrorCb

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft