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

# XTaskQueue 库概述

> 了解 XTaskQueue 库如何控制任务的运行时间和位置，包括端口分派模式、默认进程任务队列和 XTaskQueueHandle。

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

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

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

有关 XTaskQueue API 的更多信息，请参阅 [XTaskQueue](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/xtaskqueue_members.md)。

## XTaskQueueHandle

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

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

## 参考 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)
    * [xtaskqueuedispatch](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)
    * [xtaskqueueregistermonitor](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
    * [xtaskqueueregisterwaiter](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
    * [xtaskqueuesetcurrentprocesstaskqueue](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
* [xasync (API 内容)](https://docs.xbox.com/zh-CN/reference/system/xasync/xasync_members.md)
  * 结构体
    * [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)

## 另请参阅

[示例：创建任务队列](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-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-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
[XAsync](https://docs.xbox.com/zh-CN/reference/system/xasync/xasync_members.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

- [XTaskQueue（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/xtaskqueue_members.md)
- [XTaskQueueSetCurrentProcessTaskQueue](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
- [XTaskQueueRegisterMonitor](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
- [XTaskQueueRegisterWaiter](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
- [XTaskQueueMonitorCallback](https://docs.xbox.com/zh-CN/reference/system/xtaskqueue/functions/xtaskqueuemonitorcallback.md)