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.
Bien que la taille des données du blob soit 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 demandes de mise à jour distinctes.

​
Valeur de retour

Type : HRESULT Résultat de la fonction.

​
Remarques

Cette fonction ne peut pas être appelée sans danger sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Vous devez appeler avec succès XGameSaveCreateUpdate avant d’effectuer cet appel. La partie stockage de cette API est conçue pour transférer facilement des données du jeu vers un stockage persistant de manière sûre, fiable et transactionnelle. Nous voulons nous assurer que les données sous-jacentes d’un conteneur sont toujours cohérentes; c’est pourquoi nous voulons que l’opération entière réussisse ou échoue de façon atomique. Nous ne voulons pas de mise à jour partielle dans laquelle certaines données de blob sont 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; lorsqu’il est prêt, le contexte entier est soumis. Notez que vous ne pouvez écrire qu’une seule modification ou 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 complétée en appelant XGameSaveSubmitUpdate. Consultez les exemples XGameSaveCreateUpdate pour connaître l’utilisation.

​
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