PFND3D11DDI_RECYCLECREATECOMMANDLIST回调函数 (d3d10umddi.h)

RecycleCreateCommandList 函数创建一个命令列表,并使以前未使用的 DDI 句柄再次完全有效。

语法

PFND3D11DDI_RECYCLECREATECOMMANDLIST Pfnd3d11ddiRecyclecreatecommandlist;

HRESULT Pfnd3d11ddiRecyclecreatecommandlist(
  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 运行时时应使用的命令列表的句柄。

返回值

RecycleCreateCommandList 返回以下值之一:

返回代码 描述
S_OK 已成功创建命令列表。
E_OUTOFMEMORY RecycleCreateCommandList 无法分配完成它所需的内存。

言论

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

有关 RecycleCreateCommandList的详细信息,请参阅 优化小型命令列表

要求

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

另请参阅

CalcPrivateCommandListSize

D3D11DDIARG_CREATECOMMANDLIST

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)