XAsyncCompletionRoutine
表示异步调用的完成回调。
语法
void XAsyncCompletionRoutine(
XAsyncBlock* asyncBlock
)
参数
asyncBlock _Inout_
类型:XAsyncBlock*
指向用于完成回调的 XAsyncBlock 的指针。
返回值
类型:void
备注
可选择指定 XAsyncCompletionRoutine
指针,为异步调用提供完成回调。 完成回调是异步调用完成后执行的回调函数。 可以在 XAsyncBlock 结构的 callback
成员中为异步调用指定 XAsyncCompletionRoutine
指针。
通常情况下,完成回调会处理对另一个线程上异步调用的结果。 完成回调表示异步调用完成时调用的回调函数。 回调函数采用 XAsyncBlock
指针,该指针随后用于获取回调函数的结果。
如果指定完成回调,则可以使用 XAsyncGetStatus 函数定期检查完成回调是否已完成,然后根据需要使用 XAsyncGetResult 和 XAsyncGetResultSize 获取已完成任务的结果。
即使调用 XAsyncCancel 取消异步调用,也会调用完成回调。
使用 XAsyncGetStatus 或完成回调的 Get\*Result
方法获取异步调用的结果。 如果取消了异步呼叫,这些方法会返回 E_ABORT
。 有关异步提供程序的实现模式(包括 Get\*Result
方法)的详细信息,请参阅异步编程模型。
要求
头文件:XAsync.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机