PFND3D11DDI_RECYCLECREATECOMMANDLIST callback function (d3d10umddi.h)

Article
02/22/2024

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)