XAsyncCompletionRoutine
Representa o retorno de chamada de conclusão de uma chamada assíncrona.Sintaxe
Parâmetros
asyncBlock _Inout_Tipo: XAsyncBlock* Um ponteiro para o XAsyncBlock do retorno de chamada de conclusão.
Valor retornado
Tipo: voidComentários
Opcionalmente, você pode especificar um ponteiroXAsyncCompletionRoutine para fornecer um retorno de chamada de conclusão para uma chamada assíncrona. Um retorno de chamada de conclusão é uma função de retorno de chamada executada após a conclusão de uma chamada assíncrona. Você pode especificar um ponteiro XAsyncCompletionRoutine no membro callback de uma estrutura XAsyncBlock para uma chamada assíncrona.
Normalmente, um retorno de chamada de conclusão processa os resultados de uma chamada assíncrona em outro thread. O retorno de chamada de conclusão representa uma função de retorno de chamada que é invocada quando a chamada assíncrona é concluída. A função de retorno de chamada recebe um ponteiro XAsyncBlock, que é usado posteriormente para obter os resultados da função de retorno de chamada.
Se você especificar um retorno de chamada de conclusão, poderá verificar periodicamente se ele foi concluído usando a função XAsyncGetStatus e, em seguida, usar XAsyncGetResult e XAsyncGetResultSize conforme necessário para obter os resultados da tarefa concluída.
Um retorno de chamada de conclusão é invocado mesmo que XAsyncCancel seja invocada para cancelar a chamada assíncrona.
Use XAsyncGetStatus ou o método Get\*Result do retorno de chamada de conclusão para obter os resultados da chamada assíncrona. Se a chamada assíncrona tiver sido cancelada, esses métodos retornarão E_ABORT. Para obter mais informações sobre o padrão de implementação de um provedor assíncrono, incluindo o método Get\*Result, consulte Modelo de programação assíncrona.
Requisitos
Cabeçalho: XAsync.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
Confira também
Membros de XAsyncXAsyncGetStatus
Modelo de programação assíncrona