XAsyncGetResult
返回来自异步提供程序的异步调用的结果。Syntax
Parameters
asyncBlock _Inout_类型:XAsyncBlock* 指向为异步调用传递给 XAsyncBegin 的 XAsyncBlock 的指针。 identity _In_opt_
类型:void* 可选。指向可用于标识异步调用的任意标记的指针。如果为对应的 XAsyncBegin 调用的 identity 参数指定了一个值,则此处必须指定相同的指针。 bufferSize _In_
类型:size_t buffer 中指定的结果缓冲区大小(以字节为单位)。 buffer _Out_writes_bytes_to_opt_(bufferSize, *bufferUsed)
类型:void* 指向结果缓冲区的指针。 bufferUsed _Out_opt_
类型:size_t* 可选。指向包含写入到 buffer 中指定结果缓冲区的字节数的指针。此值定义为异步提供程序调用 XAsyncComplete 时指定的 requiredResultSize 参数的值。
Return value
类型:HRESULT 成功时返回S_OK;否则,返回错误代码。有关错误代码列表,请参阅错误代码。
Remarks
如果异步调用具有数据负载,请调用此函数以返回数据负载。如果异步调用没有数据负载,则不需要调用此函数。如果对没有数据负载的异步调用调用此函数,则该函数将返回错误代码E_NOT_SUPPORTED。
如果为此异步调用的 XAsyncBegin 函数的 identity 参数指定了一个值,则必须为此函数的 identity 参数也提供相同的值。否则会发生调用不匹配,并且函数将返回错误代码 E_INVALIDARG。
此函数完成且结果在 buffer 中指定的结果缓冲区中返回后,asyncBlock 中指定的 XAsyncBlock 将完成,不再与异步调用关联。
Requirements
头文件: XAsyncProvider.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机Conceptual documentation
See also
XAsyncProvider MembersXAsyncBegin
XAsyncComplete
异步编程模型
