Skip to main content

XTaskQueueGetPort

返回给定端口的任务队列端口句柄。

Syntax

Parameters

queue   _In_
类型:XTaskQueueHandle
要从中获取端口的任务队列。 port   _In_
类型:XTaskQueuePort
要获取的端口。 portHandle   _Out_
类型:XTaskQueuePortHandle*
给定端口的任务队列端口句柄。

Return value

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

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
任务队列端口句柄归任务队列所有,不必关闭。它们用于创建复合任务队列。 下面的示例创建一个复合队列,其工作端口和完成端口都使用原始队列的工作端口。复合任务队列是由其他队列的各部分组成的任务队列。复合任务队列在一个异步任务需要调用另一个任务,并且该任务的完成是不应在完成线程上浪费周期的中间步骤时非常有用。
SubmitCallback 是在 XTaskQueueSubmitCallback 函数的代码示例中定义的帮助程序函数。

Requirements

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

Conceptual documentation

See also

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