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

# 创建任务队列示例

> 演示如何调用 XTaskQueueCreate 并为每个端口指定分派模式（例如 ThreadPool、Manual 或 Immediate），然后保存返回的 XTaskQueueHandle。

本主题提供了一个如何创建任务队列的示例。只需调用 [XTaskQueueCreate](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)，为每个端口传入相应的[模式](https://docs.xbox.com/zh-CN/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-CN/reference/system/xtaskqueue/xtaskqueue_members.md)
  * 函数
    * [XTaskQueueCreate](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)

## 另请参阅

[XTaskQueue 库概述](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue.md)

[分派任务队列（示例）](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)

[清理任务队列（示例）](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)

[设计任务队列](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-task-queue-design.md)

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


## Related topics

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