Skip to main content

XAsyncComplete

Indique que la fonction de rappel d’un fournisseur asynchrone a terminé son travail et que les résultats peuvent être retournés.

Syntaxe

Paramètres

asyncBlock   _Inout_
Type : XAsyncBlock*
Pointeur vers le XAsyncBlock qui a été passé à XAsyncBegin. result   _In_
Type : HRESULT
Résultat du travail effectué par la fonction de rappel. Si le travail est annulé, définissez cette valeur sur E_ABORT. Si du travail supplémentaire doit être effectué, définissez-la sur E_PENDING. Sinon, définissez-la sur le code de résultat approprié. requiredBufferSize   _In_
Type : size_t
Taille requise, en octets, de la charge utile de données à retourner par la fonction de rappel. Si la fonction de rappel ne retourne pas de charge utile de données, définissez cette valeur sur zéro. Ce paramètre est ignoré si la fonction de rappel retourne une erreur.

Valeur de retour

Type : void

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread soumis à des contraintes de temps. Pour plus d’informations, consultez Threads soumis à des contraintes de temps.
Cette fonction est appelée lorsque la fonction de rappel a été appelée pour effectuer ou annuler un travail asynchrone. La fonction retourne un code de résultat approprié et, le cas échéant, des informations sur la charge utile de données. La combinaison du code d’opération XAsyncOp, du travail asynchrone et de la charge utile de données de la fonction de rappel détermine généralement les valeurs à fournir pour result et requiredBufferSize lors de l’appel de cette fonction. Si la fonction de rappel a été appelée avec le code d’opération XAsyncOp::DoWork, elle doit effectuer le travail asynchrone. Si la fonction de rappel a terminé tout le travail asynchrone, définissez result sur un code d’erreur approprié. Si du travail supplémentaire doit être effectué, définissez result sur E_PENDING. Si la fonction retourne une charge utile de données, définissez requiredBufferSize sur la taille, en octets, de la mémoire tampon nécessaire pour retourner la charge utile de données ; sinon, définissez requiredBufferSize sur zéro. Si la fonction de rappel a été appelée avec le code d’opération XAsyncOp::Cancel, elle doit annuler le travail asynchrone. Définissez result sur E_ABORT et requiredBufferSize sur zéro.

Configuration requise

En-tête : XAsyncProvider.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

Membres XAsyncProvider
XAsyncBegin
Modèle de programmation asynchrone
Last modified on October 6, 2026