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 的详细信息,请参阅 Small Command Lists优化。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从 Windows 7 操作系统开始,支持 RecycleCreateCommandList。 |
目标平台 | 桌面 |
标头 | d3d10umddi.h (包括 D3d10umddi.h) |