PFND3D11DDI_RECYCLECREATECOMMANDLIST callback function (d3d10umddi.h)

The RecycleCreateCommandList function creates a command list and makes a previously unused DDI handle completely valid again.

Syntax

PFND3D11DDI_RECYCLECREATECOMMANDLIST Pfnd3d11ddiRecyclecreatecommandlist;

HRESULT Pfnd3d11ddiRecyclecreatecommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATECOMMANDLIST *unnamedParam2,
  D3D11DDI_HCOMMANDLIST unnamedParam3,
  D3D11DDI_HRTCOMMANDLIST unnamedParam4
)
{...}

Parameters

unnamedParam1

hDevice [in]

A handle to the display device (graphics context).

unnamedParam2

pCreateCommandList [in]

A pointer to a D3D11DDIARG_CREATECOMMANDLIST structure that describes the parameters that the user-mode display driver uses to create a command list.

unnamedParam3

hCommandList [in]

A handle to the driver's private data for the command list.

unnamedParam4

hRTCommandList [in]

A handle to the command list that the driver should use, when it calls back into the Direct3D runtime.

Return value

RecycleCreateCommandList returns one of the following values:

Return code Description
S_OK The command list is successfully created.
E_OUTOFMEMORY RecycleCreateCommandList could not allocate memory that is required for it to complete.

Remarks

The driver is only required to implement RecycleCreateCommandList if the driver supports the D3D11DDICAPS_COMMANDLISTS_BUILD_2 capability, which can be returned in the D3D11DDI_THREADING_CAPS structure from a call to the GetCaps(D3D10_2) function.

For more information about RecycleCreateCommandList, see Optimization for Small Command Lists.

Requirements

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

See also

CalcPrivateCommandListSize

D3D11DDIARG_CREATECOMMANDLIST

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)