XTaskQueueCallback

任务队列调用的回调。

语法

void XTaskQueueCallback(  
         void* context,  
         bool canceled  
)  

参数

context _In_opt_
类型:void*

可选。 在调用 XTaskQueueSubmitCallback 时传递的上下文指针。

canceled _In_
类型:bool

如果为 true,回调将被取消,因为任务队列即将终止。

返回值

类型:void

备注

实现 XTaskQueueCallback 回调,以便在任务队列上执行工作。 通过调用 XTaskQueueSubmitCallbackXTaskQueueSubmitDelayedCallback,可以将回调提交到任务队列的工作端口或完成端口。 任务队列的工作端口和完成端口可以具有独立的调度模式,XTaskQueueCallback 回调可被提交到任一端口。 通常,提交到工作端口的回调会在完成其工作后将相应的回调提交到完成端口。

canceled 参数的目的是确保在取消回调时,回调分配的任何资源都可以被正确释放。 如果调用 XTaskQueueCallback 回调并且 canceled 设置为 true,则回调的任务队列已通过调用 XTaskQueueTerminate 终止,并且回调已取消。 回调应释放任何已分配的资源,包括 context 中分配的内存,而不执行其他操作。

有关示例,请参阅提交回调

要求

头文件:XTaskQueue.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XTaskQueue 成员
异步编程模型
异步任务队列设计