Skip to main content

XAsyncComplete

Indica que a função de retorno de chamada de um provedor assíncrono concluiu o trabalho e os resultados podem ser retornados.

Sintaxe

Parâmetros

asyncBlock   _Inout_
Tipo: XAsyncBlock*
Um ponteiro para o XAsyncBlock que foi passado para XAsyncBegin. result   _In_
Tipo: HRESULT
O resultado do trabalho realizado pela função de retorno de chamada. Se o trabalho for cancelado, defina como E_ABORT. Se for necessário realizar mais trabalho, defina como E_PENDING. Caso contrário, defina como o código de resultado apropriado. requiredBufferSize   _In_
Tipo: size_t
O tamanho necessário, em bytes, do conteúdo de dados a ser retornado pela função de retorno de chamada. Se a função de retorno de chamada não retornar um conteúdo de dados, defina este valor como zero. Este parâmetro será ignorado se a função de retorno de chamada retornar um erro.

Valor retornado

Tipo: void

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Esta função é chamada quando a função de retorno de chamada foi chamada para realizar ou cancelar o trabalho assíncrono. A função retorna um código de resultado apropriado e, se aplicável, informações sobre o conteúdo de dados. A combinação do código de operação XAsyncOp, do trabalho assíncrono e do conteúdo de dados da função de retorno de chamada normalmente determina os valores que devem ser fornecidos para result e requiredBufferSize ao chamar esta função. Se a função de retorno de chamada tiver sido chamada com o código de operação XAsyncOp::DoWork, ela deverá realizar o trabalho assíncrono. Se a função de retorno de chamada tiver concluído todo o trabalho assíncrono, defina result como um código de erro apropriado. Se for necessário realizar mais trabalho, defina result como E_PENDING. Se a função retornar um conteúdo de dados, defina requiredBufferSize como o tamanho, em bytes, do buffer necessário para retornar o conteúdo de dados; caso contrário, defina requiredBufferSize como zero. Se a função de retorno de chamada tiver sido chamada com o código de operação XAsyncOp::Cancel, ela deverá cancelar o trabalho assíncrono. Defina result como E_ABORT e requiredBufferSize como zero.

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
Modelo de programação assíncrona
Last modified on October 6, 2026