XAsyncCompletionRoutine

表示异步调用的完成回调。

语法

void XAsyncCompletionRoutine(  
         XAsyncBlock* asyncBlock  
)  

参数

asyncBlock _Inout_
类型:XAsyncBlock*

指向用于完成回调的 XAsyncBlock 的指针。

返回值

类型:void

备注

可选择指定 XAsyncCompletionRoutine 指针,为异步调用提供完成回调。 完成回调是异步调用完成后执行的回调函数。 可以在 XAsyncBlock 结构的 callback 成员中为异步调用指定 XAsyncCompletionRoutine 指针。

通常情况下,完成回调会处理对另一个线程上异步调用的结果。 完成回调表示异步调用完成时调用的回调函数。 回调函数采用 XAsyncBlock 指针,该指针随后用于获取回调函数的结果。

如果指定完成回调,则可以使用 XAsyncGetStatus 函数定期检查完成回调是否已完成,然后根据需要使用 XAsyncGetResultXAsyncGetResultSize 获取已完成任务的结果。

即使调用 XAsyncCancel 取消异步调用,也会调用完成回调。

使用 XAsyncGetStatus 或完成回调的 Get\*Result 方法获取异步调用的结果。 如果取消了异步呼叫,这些方法会返回 E_ABORT。 有关异步提供程序的实现模式(包括 Get\*Result 方法)的详细信息,请参阅异步编程模型

要求

头文件:XAsync.h

库:xgameruntime.lib

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

另请参阅

XAsync 成员
XAsyncGetStatus
异步编程模型