> ## 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-TW/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)、
[管理](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)和[控制](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)工作佇列的方法所控制。

工作佇列可以有兩個設定為[不同
模式](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode.md)的連接埠，並可在任何執行緒上分派。
可以新增[自訂回呼](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)，以便在
特殊情況下呼叫來提供功能。

每個處理序都有一個預設工作佇列，會在系統執行緒集區中自動並行分派其工作。
如果 [XAsyncBlock](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md) 中未指定工作佇列，就會使用此工作集區。您可以[變更或移除](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
預設工作佇列。

如需 XTaskQueue API 的詳細資訊，請參閱 [XTaskQueue](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/xtaskqueue_members.md)。

## XTaskQueueHandle

建立工作佇列時，會以 `XTaskQueueHandle` 類型加以追蹤。
此控制代碼會識別工作佇列，並傳遞給
[XTaskQueue 程式庫](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/xtaskqueue_members.md)中任何處理工作佇列的函式。必須追蹤此控制代碼，
並在不再使用工作佇列時將其關閉。

如需清除工作佇列的詳細資訊，請參閱[清除工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)。

## 參考 API 文件

* [XTaskQueue (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/xtaskqueue_members.md)
  * 函式
    * [xtaskqueuecreate](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)
    * [xtaskqueuedispatch](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)
    * [xtaskqueueregistermonitor](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
    * [xtaskqueueregisterwaiter](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
    * [xtaskqueuesetcurrentprocesstaskqueue](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
* [xasync (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xasync/xasync_members.md)
  * 結構
    * [XAsyncBlock](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md)

## 另請參閱

[範例：建立工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue.md)
[範例：分派工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
[範例：清除工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
[XAsync](https://docs.xbox.com/zh-TW/reference/system/xasync/xasync_members.md)
[設計工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design.md)
[XTaskQueue](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/xtaskqueue_members.md)


## Related topics

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