Skip to main content

XAsyncGetResult

返回来自异步提供程序的异步调用的结果。

Syntax

Parameters

asyncBlock   _Inout_
类型:XAsyncBlock*
指向为异步调用传递给 XAsyncBeginXAsyncBlock 的指针。 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 Members
XAsyncBegin
XAsyncComplete
异步编程模型
最后修改于 2026年8月24日