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

# 分派工作佇列範例

> 分派工作佇列範例

本主題提供如何分派工作佇列的範例。每個[手動](/zh-TW/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode)連接埠都必須分派工作佇列。連接埠
[分派](/zh-TW/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 內容)](/zh-TW/reference/system/xtaskqueue/xtaskqueue_members)
  * 函式
    * [xtaskqueuedispatch](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuedispatch)

## 另請參閱

[XTaskQueue 程式庫概觀](/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue)

[建立工作佇列 (範例)](/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue)

[清除工作佇列 (範例)](/zh-TW/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue)

[設計工作佇列](/zh-TW/build/core-features/common/async/async-task-queue-design)

[XTaskQueue](/zh-TW/reference/system/xtaskqueue/xtaskqueue_members)


## Related topics

- [GDK 範例](/zh-TW/home/setup-install/samples.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [在 XSAPI C API 中进行异步调用](/zh-CN/services/xbox-services/fundamentals/xbox-services-api/live-flatc-async-patterns.md)
- [如何：创建线程池任务队列](/zh-CN/build/core-features/common/async/async-task-queue-design-howto/creating-thread-pool-task-queue.md)
- [XR-013 將 Microsoft 帳戶與發行者帳戶連結](/zh-TW/publishing/certification/xr/xr-013.md)