PFND3D11DDI_CREATECOMMANDLIST回呼函式 (d3d10umddi.h)
CreateCommandList 函式會建立命令清單。
語法
PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;
void Pfnd3d11ddiCreatecommandlist(
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 執行時間時,應該使用的命令清單句柄。
傳回值
無
備註
驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。
只有在驅動程式支援可從 GetCaps (D3D10_2) 函式呼叫傳回的 D3D11DDI_THREADING_CAPS 結構中傳回的 D3D11DDICAPS_COMMANDLISTS_BUILD_2 功能時,才需要驅動程式來實作 CreateCommandList。
如果驅動程式用盡記憶體) ,或是在 呼叫 pfnSetErrorCb 函式時) 移除裝置,則驅動程式可以傳遞 D3DDDIERR_DEVICEREMOVED (E_OUTOFMEMORY (。 Direct3D 運行時間會判斷任何其他錯誤都很重要。 如果驅動程式通過包含D3DDDIERR_DEVICEREMOVED的任何錯誤,Direct3D 運行時間會判斷句柄無效;因此,運行時間不會呼叫 DestroyCommandList 函式來終結 hCommandList 參數指定的句柄。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 7 操作系統開始,支援 CreateCommandList。 |
目標平台 | 桌面 |
標頭 | d3d10umddi.h (包含 D3d10umddi.h) |