Skip to main content

XTaskQueueCreate

创建任务队列,该队列可用于将调用排队并调度。

Syntax

Parameters

workDispatchMode   _In_
类型:XTaskQueueDispatchMode
队列“工作”端口的调度模式。 completionDispatchMode   _In_
类型:XTaskQueueDispatchMode
队列“完成”端口的调度模式。 queue   _Out_
类型:XTaskQueueHandle*
新创建的队列。

Return value

类型:HRESULT HRESULT 成功或错误代码。

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
任务队列是引用计数对象。通过调用 XTaskQueueCloseHandle 释放引用。 任务队列有工作端口和完成端口,任务可以排队到任一端口。每个端口都可以配置自己的调度模式。 对于大多数场景,可使用 XTaskQueueCreate API 创建任务队列。但是,如果要将多个异步调用链接在一起,则通过 XTaskQueueCreateComposite 创建复合队列有时会很有用。考虑一个 API,其实现需要调用另一个使用任务队列的 API。你可能希望重定向 API 的完成回调,以便它不会占用调用方的完成线程。在这种情况下,你可以创建一个复合任务队列,其工作端口和完成端口是从另一个队列的工作端口构建的。 以下示例创建一个任务队列,该队列在系统线程池上调度工作和完成回调。
SubmitCallback 是在 XTaskQueueSubmitCallback 函数的代码示例中定义的帮助程序函数。
以下示例创建一个手动抽取的任务队列。它创建两个 STL 线程,分别为工作端口和完成端口调度调用。
SubmitCallback 是在 XTaskQueueSubmitCallback 函数的代码示例中定义的帮助程序函数。

Requirements

头文件: XTaskQueue.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XTaskQueue 成员
异步编程模型
异步任务队列设计
最后修改于 2026年8月24日