> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateCommandQueue

> 创建命令队列。

创建命令队列。

另请参阅 [ID3D12Device9::CreateCommandQueue1](/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public)。

## 语法

```cpp theme={null}
HRESULT CreateCommandQueue(
    const D3D12_COMMAND_QUEUE_DESC  pDesc,
    const IID & riid,
    void  ppCommandQueue
)
```

### 参数

*pDesc*\
类型：const D3D12\_COMMAND\_QUEUE\_DESC \*

指定描述命令队列的 **D3D12\_COMMAND\_QUEUE\_DESC**。

*riid*\
类型：const IID &

命令队列接口的全局唯一标识符 (GUID)。请参阅 **备注**。输入参数。

*ppCommandQueue*\
类型：void \*\*

指向内存块的指针，该内存块接收命令队列的 [ID3D12CommandQueue](/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs) 接口的指针。

### 返回值

类型：HRESULT

如果没有足够的内存来创建命令队列，则此方法返回 **E\_OUTOFMEMORY**。有关其他可能的返回值，请参阅 [Direct3D 12 返回代码](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 备注

可以使用 \_\_uuidof() 宏获取命令队列接口的 **REFIID** 或 **GUID**。例如，\_\_uuidof(ID3D12CommandQueue) 将获取命令队列接口的 **GUID**。

## 示例

[D3D12HelloTriangle](https://learn.microsoft.com/en-us/windows/win32/direct3d12/working-samples) 示例按以下方式使用 **ID3D12Device::CreateCommandQueue**：

```cpp theme={null}
D3D12_COMMAND_QUEUE_DESC queueDesc{};
queueDesc.Flags = D3D12_COMMAND_QUEUE_FLAG_NONE;
queueDesc.Type = D3D12_COMMAND_LIST_TYPE_DIRECT;

ThrowIfFailed(m_device->CreateCommandQueue(&queueDesc, IID_PPV_ARGS(&m_commandQueue)));
```

请参阅 [D3D12 参考中的示例代码](https://learn.microsoft.com/en-us/windows/win32/direct3d12/notes-on-example-code)。

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h\
**库：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**：XBOX Series 主机和 XBOX One 系列

## 另请参阅

* [ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)
* [ID3D12Device9::CreateCommandQueue1](/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public)


## Related topics

- [CreateCommandQueue1 (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public.md)
- [D3D12_COMMAND_QUEUE_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_command_queue_desc_public.md)
- [D3D12_COMMAND_QUEUE_PRIORITY](/zh-CN/reference/graphics/d3d12/enums/d3d12_command_queue_priority_public.md)
- [ID3D12CommandQueue::Signal](/zh-CN/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_signal_public.md)
- [XTaskQueueCreate](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)