PFND3D11DDI_RECYCLECOMMANDLIST回调函数 (d3d10umddi.h)
RecycleCommandList 函数回收命令列表。
语法
PFND3D11DDI_RECYCLECOMMANDLIST Pfnd3d11ddiRecyclecommandlist;
void Pfnd3d11ddiRecyclecommandlist(
D3D10DDI_HDEVICE unnamedParam1,
D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}
参数
unnamedParam1
hDevice [in]
显示设备的句柄 (图形上下文) 。
unnamedParam2
hCommandList [in]
要回收的命令列表的驱动程序专用数据的即时上下文句柄。
返回值
无
备注
驱动程序可以使用 pfnSetErrorCb 回调函数来设置错误代码。
仅当驱动程序支持D3D11DDICAPS_COMMANDLISTS_BUILD_2线程功能位时，驱动程序才需要实现 RecycleCommandList 。 驱动程序可以从调用驱动程序的 GetCaps (D3D10_2) 函数返回 D3D11DDI_THREADING_CAPS 结构的 Caps 成员中的D3D11DDICAPS_COMMANDLISTS_BUILD_2。
有关 RecycleCommandList 的详细信息，请参阅 Small Command Lists优化。
驱动程序不应遇到任何错误，D3DDDIERR_DEVICEREMOVED除外。 因此，如果驱动程序在调用 pfnSetErrorCb 函数时传递了除D3DDDIERR_DEVICEREMOVED以外的任何错误，则 Direct3D 运行时将确定错误严重。 即使删除了设备，驱动程序也不需要返回D3DDDIERR_DEVICEREMOVED。 但是，如果设备删除干扰 了 RecycleCommandList (通常不应) 发生的操作，驱动程序可以返回D3DDDIERR_DEVICEREMOVED。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows 7 操作系统开始，支持 RecycleCommandList。 |
| 目标平台 | 桌面 |
| 标头 | d3d10umddi.h (包括 D3d10umddi.h) |