XAsyncCompletionRoutine
Représente le rappel d’achèvement d’un appel asynchrone.Syntaxe
Paramètres
asyncBlock _Inout_Type : XAsyncBlock* Pointeur vers la structure XAsyncBlock du rappel d’achèvement.
Valeur de retour
Type : voidRemarques
Vous pouvez éventuellement spécifier un pointeurXAsyncCompletionRoutine pour fournir un rappel d’achèvement à un appel asynchrone. Un rappel d’achèvement est une fonction de rappel qui s’exécute après l’achèvement d’un appel asynchrone. Vous pouvez spécifier un pointeur XAsyncCompletionRoutine dans le membre callback d’une structure XAsyncBlock pour un appel asynchrone.
En général, un rappel d’achèvement traite les résultats d’un appel asynchrone sur un autre thread. Le rappel d’achèvement représente une fonction de rappel invoquée lorsque l’appel asynchrone se termine. La fonction de rappel prend un pointeur XAsyncBlock, qui est ensuite utilisé pour obtenir les résultats de la fonction de rappel.
Si vous spécifiez un rappel d’achèvement, vous pouvez vérifier périodiquement si le rappel d’achèvement est terminé à l’aide de la fonction XAsyncGetStatus, puis utiliser XAsyncGetResult et XAsyncGetResultSize selon les besoins pour obtenir les résultats de la tâche terminée.
Un rappel d’achèvement est invoqué même si XAsyncCancel est invoqué pour annuler l’appel asynchrone.
Utilisez XAsyncGetStatus ou la méthode Get\*Result du rappel d’achèvement pour obtenir les résultats de l’appel asynchrone. Si l’appel asynchrone a été annulé, ces méthodes renvoient E_ABORT. Pour plus d’informations sur le modèle d’implémentation d’un fournisseur asynchrone, notamment la méthode Get\*Result, consultez Modèle de programmation asynchrone.
Configuration requise
En-tête : XAsync.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
Voir aussi
Membres XAsyncXAsyncGetStatus
Modèle de programmation asynchrone