清理任务队列示例 - XBOX Game Development Documentation

本主题提供了一个如何在不再需要任务队列时对其进行清理以避免资源泄漏的示例。但是，任务队列不能立即释放。必须先终止它，刷新以确保已入队的所有内容都已运行，然后再释放。终止调用可以设置为等待或立即返回。如果回调不等待，则可以选择在终止完全完成时收到通知。如果存在任何手动端口，则必须继续对其进行分派，直到分派函数返回。

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

此示例通过 XTaskQueueTerminate 的等待参数终止任务队列但不等待。terminate 调用会向每个端口添加一个回调，以检测队列何时清空。为了处理这种情况和任何先前入队的回调，会持续调用 dispatch，直到它返回 false。

参考 API 文档

XTaskQueue (API 内容)
- 函数
  - xtaskqueueterminate
  - xtaskqueuedispatch

另请参阅

XTaskQueue 库概述创建任务队列（示例）分派任务队列（示例）设计任务队列 XTaskQueue

最后修改于 2026年8月13日

相关主题

用于异步任务编程的 XAsync 库创建任务队列示例分派任务队列示例 XTaskQueue 库概述 XTaskQueueDispatch

⌘I