PFND3D11DDI_RECYCLECREATEDEFERREDCONTEXT callback function (d3d10umddi.h)

Article
02/22/2024

The RecycleCreateDeferredContext function clears out the pipeline state for a deferred context.

Syntax

PFND3D11DDI_RECYCLECREATEDEFERREDCONTEXT Pfnd3d11ddiRecyclecreatedeferredcontext;

HRESULT Pfnd3d11ddiRecyclecreatedeferredcontext(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATEDEFERREDCONTEXT *unnamedParam2
)
{...}

Parameters

unnamedParam1

hDevice [in]

A handle to the display device (graphics context).

unnamedParam2

pCreateDeferredContext [in]

A pointer to a D3D11DDIARG_CREATEDEFERREDCONTEXT structure, which describes the parameters that the user-mode display driver uses to create a deferred context.

Return value

RecycleCreateDeferredContext returns one of the following values:

Return code	Description
S_OK	The deferred context is successfully created.
E_OUTOFMEMORY	RecycleCreateDeferredContext could not allocate memory that is required for it to complete.

Remarks

The driver is only required to implement RecycleCreateDeferredContext if the driver supports the D3D11DDICAPS_COMMANDLISTS_BUILD_2 threading-capability bit. The driver can return D3D11DDICAPS_COMMANDLISTS_BUILD_2 in the Caps member of the D3D11DDI_THREADING_CAPS structure from a call to the driver's GetCaps(D3D10_2) function.

For more information about RecycleCreateDeferredContext, see Introduction to Deferred Contexts.

Requirements

Requirement	Value
Minimum supported client	RecycleCreateDeferredContext is supported beginning with the Windows 7 operating system.
Target Platform	Desktop
Header	d3d10umddi.h (include D3d10umddi.h)