Share via

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 清單 優化。

除了D3DDDIERR_DEVICEREMOVED之外，驅動程式不應該發生任何錯誤。 因此，如果驅動程式通過任何錯誤，但除了D3DDDIERR_DEVICEREMOVED之外，在 pfnSetErrorCb 函式的呼叫中，Direct3D 運行時間會判斷錯誤很重要。 即使移除裝置，驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED。 不過，如果裝置移除干擾 回收CommandList 的作業 (通常不應該發生) ，則驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。

規格需求

需求 值
最低支援的用戶端 從 Windows 7 操作系統開始，支援 RecycleCommandList。
目標平台 桌面
標頭 d3d10umddi.h (include D3d10umddi.h)

另請參閱

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps (D3D10_2)

pfnSetErrorCb