XTaskQueueCallback
任务队列调用的回调。
语法
void XTaskQueueCallback(
void* context,
bool canceled
)
参数
context _In_opt_
类型:void*
可选。 在调用 XTaskQueueSubmitCallback 时传递的上下文指针。
canceled _In_
类型:bool
如果为 true,回调将被取消,因为任务队列即将终止。
返回值
类型:void
备注
实现 XTaskQueueCallback
回调,以便在任务队列上执行工作。 通过调用 XTaskQueueSubmitCallback 或 XTaskQueueSubmitDelayedCallback,可以将回调提交到任务队列的工作端口或完成端口。 任务队列的工作端口和完成端口可以具有独立的调度模式,XTaskQueueCallback
回调可被提交到任一端口。 通常,提交到工作端口的回调会在完成其工作后将相应的回调提交到完成端口。
canceled
参数的目的是确保在取消回调时,回调分配的任何资源都可以被正确释放。 如果调用 XTaskQueueCallback
回调并且 canceled
设置为 true,则回调的任务队列已通过调用 XTaskQueueTerminate 终止,并且回调已取消。 回调应释放任何已分配的资源,包括 context
中分配的内存,而不执行其他操作。
有关示例,请参阅提交回调。
要求
头文件:XTaskQueue.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机