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

# 建立工作佇列範例

> 示範如何為每個連接埠以 ThreadPool、Manual 或 Immediate 等分派模式呼叫 XTaskQueueCreate，並儲存傳回的 XTaskQueueHandle。

本主題提供如何建立工作佇列的範例。只要呼叫 [XTaskQueueCreate](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)、
傳入每個連接埠的[模式](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode.md)，然後儲存所建立的控制代碼即可。

```c++ theme={null}
XTaskQueueHandle taskQueue1;
HRESULT hr = XTaskQueueCreate(
    XTaskQueueDispatchMode::ThreadPool,
    XTaskQueueDispatchMode::Manual,
    &taskQueue1);

XTaskQueueHandle taskQueue2;
hr = XTaskQueueCreate(
    XTaskQueueDispatchMode::Immediate,
    XTaskQueueDispatchMode::SerializedThreadPool,
    &taskQueue2);
```

如果傳回碼沒有錯誤，工作佇列現在就會
以傳回的 `XTaskQueueHandle` 表示。

## 參考 API 文件

* [XTaskQueue (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/xtaskqueue_members.md)
  * 函式
    * [XTaskQueueCreate](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)

## 另請參閱

[XTaskQueue 程式庫概觀](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue.md)

[分派工作佇列 (範例)](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)

[清除工作佇列 (範例)](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)

[設計工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design.md)

[XTaskQueue](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/xtaskqueue_members.md)


## Related topics

- [用於非同步工作程式設計的 XAsync 程式庫](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/index.md)
- [清除工作佇列範例](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
- [分派工作佇列範例](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
- [操作說明：建立執行緒集區工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design-howto/creating-thread-pool-task-queue.md)
- [操作說明：建立手動工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design-howto/creating-manual-task-queue.md)