Skip to main content
建立命令清單。

語法

參數

pDesc _In_
類型:D3D12XBOX_COMMAND_LIST_DESC*
要建立之命令清單的描述。 pCommandAllocator _In_
類型:ID3D12CommandAllocator*
指向 ID3D12CommandAllocator 物件的指標,裝置會從此物件建立命令清單。 pInitialState _In_opt_
類型:ID3D12PipelineState*
指向 ID3D12PipelineState 物件的指標,該物件包含命令清單的初始管線狀態。 此參數為選擇性,可以設定為 NULL。如果設定為 NULL,執行階段會設定一個虛設的初始管線狀態,讓驅動程式遇到未定義的狀態。這樣做的額外負荷很低,特別是對命令清單而言,因為錄製命令清單的整體成本遠大於設定初始狀態的成本。因此,如果設定初始管線狀態參數並不方便,不設定它的成本也很小。 riid
類型:REFIID
命令清單介面的全域唯一識別碼 (GUID)。若要擷取管線狀態介面的 REFIID (或 GUID),請使用 __uuidof() 巨集。例如,若要取得命令清單介面的 GUID,請執行下列動作:
ppCommandList _Outptr_
類型:void**
指向記憶體區塊的指標,該區塊會接收指向命令清單之 ID3D12CommandList 或 ID3D12GraphicsCommandList 介面的指標。

傳回值

類型:HRESULT 如果沒有足夠的記憶體可建立命令清單,此方法會傳回 E_OUTOFMEMORY。如需其他可能的傳回值,請參閱 Direct3D 12 傳回碼。

備註

裝置會從命令配置器建立命令清單。如需命令配置器的詳細資訊,請參閱 CreateCommandAllocator 和建立和錄製命令清單與套件組合。 如需建立命令清單的詳細資訊,請參閱 CreateCommandList。

需求

標頭: d3d12_x.h 程式庫: d3d12_x.lib 支援的平台: XBOX One 系列

另請參閱

ID3D12Device
Last modified on October 6, 2026