PFND3D11DDI_CREATECOMMANDLIST回调函数 (d3d10umddi.h)

CreateCommandList 函数创建命令列表。

语法

PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;

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

参数

unnamedParam1

hDevice [in]

显示设备的句柄(图形上下文)。

unnamedParam2

pCreateCommandList [in]

指向 D3D11DDIARG_CREATECOMMANDLIST 结构的指针,该结构描述用户模式显示驱动程序用于创建命令列表的参数。

unnamedParam3

hCommandList [in]

命令列表驱动程序专用数据的句柄。

unnamedParam4

hRTCommandList [in]

驱动程序在调用 Direct3D 运行时时应使用的命令列表的句柄。

返回值

没有

言论

驱动程序可以使用 pfnSetErrorCb 回调函数来设置错误代码。

仅当驱动程序支持 D3D11DDI_THREADING_CAPS 结构中可从调用 GetCaps(D3D10_2) 函数返回的D3D11DDICAPS_COMMANDLISTS_BUILD_2功能时,驱动程序才需要实现 CreateCommandList

驱动程序可以在调用 pfnSetErrorCb 函数时传递E_OUTOFMEMORY(如果驱动程序内存不足)或D3DDDIERR_DEVICEREMOVED(如果设备已删除)。 Direct3D 运行时确定任何其他错误都至关重要。 如果驱动程序通过任何错误(包括D3DDDIERR_DEVICEREMOVED),Direct3D 运行时将确定句柄无效;因此,运行时不调用 DestroyCommandList 函数来销毁 hCommandList 参数指定的句柄。

要求

要求 价值
最低支持的客户端 从 Windows 7作系统开始,支持 CreateCommandList。
目标平台 桌面
标头 d3d10umddi.h (包括 D3d10umddi.h)

另请参阅

CalcPrivateCommandListSize

D3D11DDIARG_CREATECOMMANDLIST

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

DestroyCommandList

GetCaps(D3D10_2)

pfnSetErrorCb