Skip to main content

XAsyncGetResult

Retorna os resultados de uma chamada assíncrona de um provedor assíncrono.

Sintaxe

Parâmetros

asyncBlock   _Inout_
Tipo: XAsyncBlock*
Um ponteiro para o XAsyncBlock que foi passado para XAsyncBegin para a chamada assíncrona. identity   _In_opt_
Tipo: void*
Opcional. Um ponteiro para um token arbitrário que pode ser usado para identificar a chamada assíncrona. Se um valor tiver sido especificado para o parâmetro identity da chamada XAsyncBegin correspondente, o mesmo ponteiro deverá ser especificado aqui. bufferSize   _In_
Tipo: size_t
O tamanho, em bytes, do buffer de resultado especificado em buffer. buffer   _Out_writes_bytes_to_opt_(bufferSize, *bufferUsed)
Tipo: void*
Um ponteiro para o buffer de resultado. bufferUsed   _Out_opt_
Tipo: size_t*
Opcional. Um ponteiro que contém o número de bytes gravados no buffer de resultado especificado em buffer. Esse valor é definido como o valor do parâmetro requiredResultSize, especificado pelo provedor assíncrono quando XAsyncComplete foi invocado.

Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Se a chamada assíncrona tiver um conteúdo de dados, invoque esta função para retornar o conteúdo de dados. Você não precisará invocar esta função se a chamada assíncrona não tiver um conteúdo de dados. Se esta função for invocada para uma chamada assíncrona que não tem um conteúdo de dados, a função retornará o código de erro E_NOT_SUPPORTED. Se um valor tiver sido especificado para o parâmetro identity da função XAsyncBegin para esta chamada assíncrona, esse mesmo valor também deverá ser fornecido para o parâmetro identity desta função. Caso contrário, ocorrerá uma incompatibilidade de chamada e a função retornará o código de erro E_INVALIDARG. Depois que esta função for concluída e os resultados forem retornados no buffer de resultado especificado em buffer, o XAsyncBlock especificado em asyncBlock será concluído e não estará mais associado à chamada assíncrona.

Requisitos

Cabeçalho: XAsyncProvider.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

Membros de XAsyncProvider
XAsyncBegin
XAsyncComplete
Modelo de programação assíncrona
Last modified on October 6, 2026