Skip to main content

XGameSaveSubmitUpdateAsync

Soumet une mise à jour au service XGameSave de manière asynchrone. Met à jour les blobs d’un conteneur.

Syntaxe

Paramètres

updateContext   _In_
Type : XGameSaveUpdateHandle
Handle vers le XGameSaveUpdate à mettre à jour. async   _In_
Type : XAsyncBlock*
AsyncBlock contenant le contexte d’appel et la fonction de rappel de l’appel à XGameSaveSubmitUpdateAsync.

Valeur de retour

Type : HRESULT Résultat de la fonction

Remarques

Cette fonction est appelée dans le cadre de la fonction d’appel AsyncBlock de XGameSaveSubmitUpdateAsync. Elle permet de déterminer les résultats de XGameSaveSubmitUpdateAsync. La partie stockage de cette API est conçue pour transférer facilement les données du jeu vers un stockage persistant de manière sûre, fiable et transactionnelle. Nous voulons garantir que les données sous-jacentes d’un conteneur restent toujours cohérentes ; c’est pourquoi l’opération entière doit réussir ou échouer de manière atomique. Nous ne voulons pas de mise à jour partielle dans laquelle certaines données de blob seraient incohérentes avec d’autres données du conteneur. Pour ce faire, nous fournissons un contexte de mise à jour auquel les écritures et suppressions de blobs sont soumises, puis, lorsqu’il est prêt, le contexte entier est soumis. En pratique, cela se présente comme suit : Un XGameSaveUpdate est rempli d’actions d’écriture (Write) et de suppression (Delete) à effectuer sur les blobs du conteneur au moyen de XGameSaveSubmitBlobWrite et XGameSaveSubmitBlobDelete. Une mise à jour est finalisée en appelant XGameSaveSubmitUpdateAsync. Lorsque vous avez terminé avec un XGameSaveUpdate, fermez-le à l’aide de la méthode XGameSaveCloseUpdate. L’exemple C++ suivant illustre une mise à jour XGameSave asynchrone.

Configuration requise

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

Documentation conceptuelle

Voir aussi

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
Débogage des sauvegardes de jeu
Last modified on October 6, 2026