Skip to main content

​
XGameSaveSubmitBlobWrite

Ajoute une action d’écriture à un XGameSaveUpdate.

​
Syntaxe

​
Paramètres

updateContext   _In_
Type : XGameSaveUpdateHandle Handle vers le XGameSaveUpdate dans lequel le blob sera écrit. blobName   _In_z_
Type : char* Nom du blob à écrire. La taille du nom du blob ne doit pas dépasser GS_MAX_BLOB_NAME_SIZE, en octets. data   _In_reads_bytes_(byteCount)
Type : uint8_t* Données à écrire dans le blob. byteCount   _In_
Type : size_t Taille des données à écrire dans le blob. La taille des données du blob ne doit pas dépasser GS_MAX_BLOB_SIZE, en octets.
Si la taille des données du blob est limitée à GS_MAX_BLOB_SIZE, la mise à jour entière est également limitée à GS_MAX_BLOB_SIZE. Si une mise à jour contient un blob de GS_MAX_BLOB_SIZE, les mises à jour supplémentaires doivent être effectuées dans des requêtes de mise à jour distinctes.

​
Valeur de retour

Type : HRESULT Résultat de la fonction.

​
Remarques

Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
Vous devez appeler XGameSaveCreateUpdate avec succès avant d’effectuer cet appel. 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 sont toujours cohérentes ; c’est pourquoi l’opération entière doit réussir ou échouer de façon atomique. Nous voulons éviter une mise à jour partielle dans laquelle certaines données de blob seraient incohérentes avec d’autres données du conteneur. Pour cela, nous fournissons un contexte de mise à jour auquel les écritures et suppressions de blobs sont soumises ; lorsqu’il est prêt, l’ensemble du contexte est soumis. Notez que vous ne pouvez écrire qu’une seule modification/suppression par blob dans un contexte de mise à jour. En pratique, cela se présente comme suit : Un XGameSaveUpdate est rempli d’actions d’écriture et de suppression à effectuer sur les blobs du conteneur au moyen de XGameSaveSubmitBlobWrite et XGameSaveSubmitBlobDelete. Une mise à jour est finalisée en appelant XGameSaveSubmitUpdate. Pour des exemples d’utilisation, consultez les exemples XGameSaveCreateUpdate.

​
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
XGameSaveSubmitUpdate
XGameSaveSubmitBlobDelete
Débogage des sauvegardes de jeu
Last modified on October 6, 2026