> ## 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](/zh-TW/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](/zh-TW/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)。

## 備註

命令佇列介面的 **REFIID** (或 **GUID**) 可以使用 \_\_uuidof() 巨集取得。例如，\_\_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](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)
* [ID3D12Device9::CreateCommandQueue1](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public)


## Related topics

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