PFND3D11_1DDI_CREATERASTERIZERSTATE callback function (d3d10umddi.h)

Article
02/22/2024

Creates a rasterizer state.

Syntax

PFND3D11_1DDI_CREATERASTERIZERSTATE Pfnd3d111DdiCreaterasterizerstate;

void Pfnd3d111DdiCreaterasterizerstate(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11_1_DDI_RASTERIZER_DESC *unnamedParam2,
  D3D10DDI_HRASTERIZERSTATE unnamedParam3,
  D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}

Parameters

unnamedParam1

hDevice [in]

A handle to the display device (graphics context).

unnamedParam2

pRasterizerDesc [in]

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

unnamedParam3

hRasterizerState [in]

A handle to the driver's private data for the rasterizer state.

unnamedParam4

hRTRasterizerState

A handle to the rasterizer state that the driver should use when it calls back into the Direct3D runtime.

Return value

None

Remarks

The driver can use the pfnSetErrorCb callback function to set an error code.

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 incorrect; 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

Requirement	Value
Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Target Platform	Desktop
Header	d3d10umddi.h (include D3d10umddi.h)