Skip to main content

XTaskQueueCreateComposite

创建由其他任务队列的端口组成的任务队列。

Syntax

Parameters

workPort   _In_
类型:XTaskQueuePortHandle
用于排队工作回调的端口。 completionPort   _In_
类型:XTaskQueuePortHandle
用于排队完成回调的端口。 queue   _Out_
类型:XTaskQueueHandle*
新创建的队列。

Return value

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

Remarks

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

Requirements

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

Conceptual documentation

See also

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