清除工作佇列範例 - XBOX Game Development Documentation

本主題提供在不再需要工作佇列時如何清除工作佇列的範例，以避免資源洩漏。不過，工作佇列無法直接立即釋放。必須先終止它、加以排清以確保已執行所有加入其中的項目，然後再釋放它。終止呼叫可以設定為等待或立即傳回。如果不等待，可以選擇性地指定回呼，以便在終止完全結束時收到通知。如果有任何手動連接埠，就必須持續分派它們，直到分派函式傳回為止。

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

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

參考 API 文件

XTaskQueue (API 內容)
- 函式
  - xtaskqueueterminate
  - xtaskqueuedispatch

另請參閱

XTaskQueue 程式庫概觀建立工作佇列 (範例) 分派工作佇列 (範例) 設計工作佇列 XTaskQueue

最後修改於 2026年10月26日

⌘I