> ## 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.

# 创建任务队列示例

> 创建任务队列示例

本主题提供了一个如何创建任务队列的示例。只需调用 [XTaskQueueCreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate)，为每个端口传入相应的[模式](/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode)，然后保存创建的句柄即可。

```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 内容)](/reference/system/xtaskqueue/xtaskqueue_members)
  * 函数
    * [XTaskQueueCreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate)

## 另请参阅

[XTaskQueue 库概述](/build/core-features/common/async/async-libraries/async-library-xtaskqueue)

[分派任务队列（示例）](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue)

[清理任务队列（示例）](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue)

[设计任务队列](/build/core-features/common/async/async-task-queue-design)

[XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members)


## Related topics

- [用于异步任务编程的 XAsync 库](/zh-CN/build/core-features/common/async/async-libraries/index.md)
- [清理任务队列示例](/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
- [分派任务队列示例](/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
- [如何：创建手动任务队列](/zh-CN/build/core-features/common/async/async-task-queue-design-howto/creating-manual-task-queue.md)
- [如何：创建复合任务队列](/zh-CN/build/core-features/common/async/async-task-queue-design-howto/creating-composite-task-queue.md)