CreateCommandAllocator

创建命令分配器对象。

语法

HRESULT CreateCommandAllocator(
    D3D12_COMMAND_LIST_TYPE type,
    const IID & riid,
    void  ppCommandAllocator
)

参数

type [in]
类型：D3D12_COMMAND_LIST_TYPE D3D12_COMMAND_LIST_TYPE 类型的值，用于指定要创建的命令分配器的类型。命令分配器的类型可以是记录直接命令列表或捆绑包的类型。 riid
类型：const IID & 命令分配器接口（ID3D12CommandAllocator）的全局唯一标识符 (GUID)。可以使用 __uuidof() 宏获取命令分配器接口的 REFIID 或 GUID。例如，__uuidof(ID3D12CommandAllocator) 将获取命令分配器接口的 GUID。 ppCommandAllocator [out]
类型：void ** 指向内存块的指针，该内存块接收命令分配器的 ID3D12CommandAllocator 接口的指针。

返回值

类型：HRESULT 如果没有足够的内存来创建命令分配器，则此方法返回 E_OUTOFMEMORY。有关其他可能的返回值，请参阅 Direct3D 12 返回代码。

备注

设备从命令分配器创建命令列表。

示例

D3D12Bundles 示例按以下方式使用 ID3D12Device::CreateCommandAllocator：

ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));
ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_BUNDLE, IID_PPV_ARGS(&m_bundleAllocator)));

请参阅 D3D12 参考中的示例代码。

要求

头文件： d3d12_xs.h 或 d3d12_x.h
库： d3d12_xs.lib 或 d3d12_x.lib
支持的平台：XBOX Series 主机和 XBOX One 系列

另请参阅

ID3D12Device

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

语法

参数

返回值

备注

示例

要求

另请参阅

​语法

​参数

​返回值

​备注

​示例

​要求

​另请参阅

语法

参数

返回值

备注

示例

要求

另请参阅