ID3D12Device4：：CreateCommandList1 方法 (d3d12.h)

建立處於關閉狀態的命令清單。 另請參閱 ID3D12Device：：CreateCommandList。

語法

HRESULT CreateCommandList1(
  [in]  UINT                     nodeMask,
  [in]  D3D12_COMMAND_LIST_TYPE  type,
        D3D12_COMMAND_LIST_FLAGS flags,
  [in]  REFIID                   riid,
  [out] void                     **ppCommandList
);

參數

[in] nodeMask

類型： UINT

針對單一 GPU 作業，請將此設定為零。 如果有多個 GPU 節點，請設定一個位來識別節點， (裝置的實體適配卡) 建立命令清單。 遮罩中的每個位都會對應至單一節點。 只能設定一個位。 另請參閱 多配接器系統。

[in] type

類型： D3D12_COMMAND_LIST_TYPE

指定要建立的命令清單類型。

flags

類型： D3D12_COMMAND_LIST_FLAGS

指定建立旗標。

[in] riid

類型： REFIID

在 ppCommandList 中傳回之命令清單介面 (GUID) 全域唯一標識符的參考。

[out] ppCommandList

類型： void**

記憶體區塊的指標，接收命令清單之 ID3D12CommandList 或 ID3D12GraphicsCommandList 介面的指標。

傳回值

類型： HRESULT

如果函式成功，它會 傳回S_OK。 否則，它會傳回 HRESULT錯誤碼。

傳回值	描述
E_OUTOFMEMORY	記憶體不足，無法建立命令清單。

如需其他可能的傳回值，請參閱 Direct3D 12 傳回碼 。

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
目標平台	Windows
標頭	d3d12.h
程式庫	d3d12.lib
Dll	d3d12.dll

另請參閱

ID3D12Device：：CreateCommandList