PFND3D11DDI_RECYCLECREATECOMMANDLIST回调函数 (d3d10umddi.h)

项目
02/26/2024

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 的详细信息，请参阅 Small Command Lists优化。

要求

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