Expand Minimize

CreateBlendState(D3D11_1) routine

Creates a blend state.

Syntax


PFND3D11_1DDI_CREATEBLENDSTATE CreateBlendState(D3D11_1);

VOID APIENTRY* CreateBlendState(D3D11_1)(
  D3D10DDI_HDEVICE hDevice,
  _In_  const D3D11_1_DDI_BLEND_DESC ,
  D3D10DDI_HBLENDSTATE hBlendState,
  D3D10DDI_HRTBLENDSTATE hRTBlendState
)
{ ... }

Parameters

hDevice

A handle to the display device (graphics context).

[in]

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

hBlendState

A handle to the driver's private data for the blend 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 CalcPrivateBlendStateSize(D3D11_1) 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 blend state object.

hRTBlendState

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

Return value

The driver can use the pfnSetErrorCb callback function to set an error code. For more information about setting error codes, see the 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 incorrect; therefore, the runtime will not call the DestroyBlendState function to destroy the handle that the hBlendState parameter specifies.

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

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateBlendStateSize(D3D11_1)
D3D11_1_DDI_BLEND_DESC
DestroyBlendState
pfnSetErrorCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft