XAsyncGetResult
Retourne les résultats d’un appel asynchrone provenant d’un fournisseur asynchrone.Syntaxe
Paramètres
asyncBlock _Inout_Type : XAsyncBlock* Pointeur vers le XAsyncBlock qui a été passé à XAsyncBegin pour l’appel asynchrone. identity _In_opt_
Type : void* Facultatif. Pointeur vers un jeton arbitraire qui peut être utilisé pour identifier l’appel asynchrone. Si une valeur a été spécifiée pour le paramètre identity de l’appel XAsyncBegin correspondant, le même pointeur doit être spécifié ici. bufferSize _In_
Type : size_t Taille, en octets, de la mémoire tampon de résultat spécifiée dans buffer. buffer _Out_writes_bytes_to_opt_(bufferSize, *bufferUsed)
Type : void* Pointeur vers la mémoire tampon de résultat. bufferUsed _Out_opt_
Type : size_t* Facultatif. Pointeur qui contient le nombre d’octets écrits dans la mémoire tampon de résultat spécifiée dans buffer. Cette valeur correspond à la valeur du paramètre requiredResultSize, spécifiée par le fournisseur asynchrone lors de l’appel de XAsyncComplete.
Valeur de retour
Type : HRESULT RetourneS_OK en cas de réussite ; sinon, retourne un code d’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.
Remarques
Si l’appel asynchrone possède une charge utile de données, appelez cette fonction pour retourner la charge utile de données. Vous n’avez pas besoin d’appeler cette fonction si l’appel asynchrone ne possède pas de charge utile de données. Si cette fonction est appelée pour un appel asynchrone qui ne possède pas de charge utile de données, la fonction retourne le code d’erreurE_NOT_SUPPORTED.
Si une valeur a été spécifiée pour le paramètre identity de la fonction XAsyncBegin pour cet appel asynchrone, cette même valeur doit également être fournie pour le paramètre identity de cette fonction. Sinon, une non-concordance d’appel se produit et la fonction retourne le code d’erreur E_INVALIDARG.
Une fois cette fonction terminée et les résultats retournés dans la mémoire tampon de résultat spécifiée dans buffer, le XAsyncBlock spécifié dans asyncBlock est terminé et n’est plus associé à l’appel asynchrone.
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 SeriesDocumentation conceptuelle
- Configurer un fournisseur personnalisé
- Configurer les données de retour
- Modèle de programmation asynchrone
Voir aussi
Membres XAsyncProviderXAsyncBegin
XAsyncComplete
Modèle de programmation asynchrone