Expand Minimize

CreateCommandList routine

The CreateCommandList function creates a command list.

Syntax


PFND3D11DDI_CREATECOMMANDLIST CreateCommandList;

VOID APIENTRY CreateCommandList(
  _In_  D3D10DDI_HDEVICE hDevice,
  _In_  const D3D11DDIARG_CREATECOMMANDLIST *pCreateCommandList,
  _In_  D3D11DDI_HCOMMANDLIST hCommandList,
  _In_  D3D11DDI_HRTCOMMANDLIST hRTCommandList
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pCreateCommandList [in]

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

hCommandList [in]

A handle to the driver's private data for the command list. 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 CalcPrivateCommandListSize function. The handle is 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 command list.

hRTCommandList [in]

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

Return value

None

The driver can use the pfnSetErrorCb callback function to set an error code. For more information about setting error codes, see the following Remarks section.

Remarks

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

The driver can pass E_OUTOFMEMORY (if the driver runs out of memory) or D3DDDIERR_DEVICEREMOVED (if the device is removed) in a call to the pfnSetErrorCb function. The Direct3D runtime determines that any other errors are critical. If the driver passes any errors, which includes D3DDDIERR_DEVICEREMOVED, the Direct3D runtime determines that the handle is invalid; therefore, the runtime does not call the DestroyCommandList function to destroy the handle that the hCommandList parameter specifies.

Requirements

Version

CreateCommandList is supported beginning with the Windows 7 operating system.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateCommandListSize
D3D11DDI_DEVICEFUNCS
D3D11DDI_THREADING_CAPS
D3D11DDIARG_CREATECOMMANDLIST
DestroyCommandList
GetCaps(D3D10_2)
pfnSetErrorCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft