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

# XTaskQueue 库概述

> XTaskQueue 库概述

使用本主题通过 XTaskQueue 库管理任务队列。此库负责运行任务的“何时”和“何处”，由任务队列以及用于[设置](/reference/system/xtaskqueue/functions/xtaskqueuecreate)、[管理](/reference/system/xtaskqueue/functions/xtaskqueuedispatch)和[控制](/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor)任务队列的方法进行控制。

任务队列可以有两个端口，分别设置为[不同模式](/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode)并在任何线程上分派。还可以添加[自定义回调](/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter)，以便在特殊情况下调用以实现相应功能。

每个进程都有一个默认任务队列，会在系统线程池中自动并发分派其任务。如果 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) 中未指定任务队列，则会使用此任务池。你可以[更改或移除](/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue)默认任务队列。

有关 XTaskQueue API 的更多信息，请参阅 [XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members)。

## XTaskQueueHandle

创建任务队列时，会通过 `XTaskQueueHandle` 类型进行跟踪。此句柄标识任务队列，并被传递给 [XTaskQueue 库](/reference/system/xtaskqueue/xtaskqueue_members)中处理任务队列的任何函数。当不再使用任务队列时，必须跟踪并关闭该句柄。

有关清理任务队列的更多信息，请参阅[清理任务队列](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue)。

## 参考 API 文档

* [XTaskQueue (API 内容)](/reference/system/xtaskqueue/xtaskqueue_members)
  * 函数
    * [xtaskqueuecreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate)
    * [xtaskqueuedispatch](/reference/system/xtaskqueue/functions/xtaskqueuedispatch)
    * [xtaskqueueregistermonitor](/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor)
    * [xtaskqueueregisterwaiter](/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter)
    * [xtaskqueuesetcurrentprocesstaskqueue](/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue)
* [xasync (API 内容)](/reference/system/xasync/xasync_members)
  * 结构体
    * [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)

## 另请参阅

[示例：创建任务队列](/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-dispatch-task-queue)
[示例：清理任务队列](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue)
[XAsync](/reference/system/xasync/xasync_members)
[设计任务队列](/build/core-features/common/async/async-task-queue-design)
[XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members)


## Related topics

- [XTaskQueue](/zh-CN/reference/system/xtaskqueue/xtaskqueue_members.md)
- [XTaskQueueSetCurrentProcessTaskQueue](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
- [XTaskQueueRegisterMonitor](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
- [XTaskQueueRegisterWaiter](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
- [XTaskQueueMonitorCallback](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuemonitorcallback.md)