> ## 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/functions/xtaskqueueterminate)可以設定為等待或
立即傳回。如果不等待，可以選擇性地指定回呼，
以便在終止完全結束時收到通知。如果有
任何[手動連接埠](/zh-TW/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode)，就必須持續分派它們，直到
[分派函式](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuedispatch)傳回為止。

```c++ theme={null}
XTaskQueueTerminate(taskQueue, false, nullptr, nullptr);
bool result;
do
{
    result = XTaskQueueDispatch(taskQueue, XTaskQueuePort::Completion, INFINITE);
} while (result == true);
XTaskQueueCloseHandle(taskQueue);
```

此範例會終止工作佇列，但透過
[XTaskQueueTerminate](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueterminate) 的 wait 參數設定為不等待。
`terminate` 呼叫會在每個連接埠新增一個回呼，以偵測佇列何時
清空。為了處理此回呼以及任何先前加入佇列的回呼，
會持續呼叫 `dispatch`，直到它傳回 `false` 為止。

## 參考 API 文件

* [XTaskQueue (API 內容)](/zh-TW/reference/system/xtaskqueue/xtaskqueue_members)
  * 函式
    * [xtaskqueueterminate](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueterminate)
    * [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-dispatch-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)
- [XR-013 將 Microsoft 帳戶與發行者帳戶連結](/zh-TW/publishing/certification/xr/xr-013.md)
- [XR-064 可加入的遊戲工作階段與線上遊戲](/zh-TW/publishing/certification/xr/xr-064.md)
- [帳戶方案升級](/zh-TW/services/playfab/pricing/account-upgrades.md)