Skip to main content

XTaskQueueCallback

由任务队列调用的回调。

Syntax

Parameters

context   _In_opt_
类型:void*
可选。调用 XTaskQueueSubmitCallback 时传入的上下文指针。 canceled   _In_
类型:bool
如果为 true,则由于任务队列正在终止,因此正在取消回调。

Return value

类型:void

Remarks

XTaskQueueCallback 回调是为了在任务队列上执行工作而实现的。可以通过调用 XTaskQueueSubmitCallbackXTaskQueueSubmitDelayedCallback 将回调提交到任务队列的工作端口或完成端口。任务队列的工作端口和完成端口可以有独立的调度模式,XTaskQueueCallback 回调可以提交到任一端口。通常,提交到工作端口的回调在完成其工作后会向完成端口提交相应的回调。 canceled 参数的用途是确保在取消回调时可以正确释放该回调分配的任何资源。如果调用 XTaskQueueCallback 回调并且 canceled 设置为 true,则表示已通过调用 XTaskQueueTerminate 终止该回调的任务队列并已取消该回调。回调应释放所有已分配的资源,包括在 context 中分配的内存,并且不执行任何其他工作。 有关示例,请参阅提交回调

Requirements

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

See also

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