タスクキューのクリーンアップ例 - 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 の呼び出しは、キューが空になった時点を検出するためのコールバックを各ポートに 1 つ追加します。このコールバックと、それ以前にエンキューされていたコールバックを処理するために、dispatch は false が返されるまで継続的に呼び出されます。

リファレンス API ドキュメント

XTaskQueue (API 目次)
- 関数
  - xtaskqueueterminate
  - xtaskqueuedispatch

関連項目

XTaskQueue ライブラリの概要タスクキューの作成 (例) タスクキューのディスパッチ (例) タスクキューの設計 XTaskQueue

最終更新日 2026年10月26日

⌘I