PFND3D10DDI_CREATERASTERIZERSTATE callback function

The CreateRasterizerState function creates a rasterizer state.

Syntax

PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;

void Pfnd3d10ddiCreaterasterizerstate(
  D3D10DDI_HDEVICE Arg1,
  const D3D10_DDI_RASTERIZER_DESC *Arg2,
  D3D10DDI_HRASTERIZERSTATE Arg3,
  D3D10DDI_HRTRASTERIZERSTATE Arg4
)
{...}

Parameters

Arg1

hDevice [in]

A handle to the display device (graphics context).

Arg2

pRasterizerDesc [in]

A pointer to a D3D10_DDI_RASTERIZER_DESC structure that describes the parameters that the user-mode display driver uses to create a rasterizer state.

Arg3

hRasterizerState [in]

A handle to the driver's private data for the rasterizer state. 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 CalcPrivateRasterizerStateSize function. The handle is really 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 rasterizer state object.

Arg4

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 can pass E_OUTOFMEMORY (if the driver runs out of memory) or D3DDDIERR_DEVICEREMOVED (if the device has been removed) in a call to the pfnSetErrorCb function. The Direct3D runtime will determine that any other errors are critical. If the driver passes any errors, including D3DDDIERR_DEVICEREMOVED, the Direct3D runtime will determine that the handle is invalid; therefore, the runtime will not call the DestroyRasterizerState function to destroy the handle that the hRasterizerState parameter specifies.

The user-mode display driver is not required to create more than 4,096 unique instances of rasterizer-state objects on a device at a time.

Requirements

   
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See Also

CalcPrivateRasterizerStateSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_RASTERIZER_DESC

DestroyRasterizerState

pfnSetErrorCb