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

# 分派任务队列示例

> 分派任务队列示例

本主题提供了一个如何分派任务队列的示例。对每个[手动](/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode)端口都需要进行分派。端口[分派](/reference/system/xtaskqueue/functions/xtaskqueuedispatch)的方式和时机决定了已入队回调的线程执行和并发行为。

```c++ theme={null}
std::thread dispatherThread = std::thread(
    [taskQueue]()
    {
        while (true)
        {
            bool processed = XTaskQueueDispatch(taskQueue,
                XTaskQueuePort::Completion, INFINITE);

            if (!processed)
            {
                // The task queue has been terminated, so return.
                break;
            }
        }
    });
```

此示例展示了生成一个额外的线程来持续分派传入任务队列的完成端口，直到该端口被终止为止。

## 参考 API 文档

* [XTaskQueue (API 内容)](/reference/system/xtaskqueue/xtaskqueue_members)
  * 函数
    * [xtaskqueuedispatch](/reference/system/xtaskqueue/functions/xtaskqueuedispatch)

## 另请参阅

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

[创建任务队列（示例）](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-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

- [清理任务队列示例](/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-create-task-queue.md)
- [XTaskQueue 库概述](/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue.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.md)