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
Library d3d12.lib
DLL d3d12.dll

另请参阅

ID3D12Device::CreateCommandList