Skip to main content

XGameSaveReadBlobData

Lit les données de blob d’un conteneur.

Syntaxe

Paramètres

container   _In_
Type : XGameSaveContainerHandle
Handle vers le XGameSaveContainer contenant les données XGameSaveBlob. blobNames   _In_opt_z_count_(countOfBlobs)
Type : char
*
Pointeur vers un tableau de chaînes représentant les noms des XGameSaveBlob. countOfBlobs   _Inout_
Type : uint32_t*
Nombre de blobs à lire. blobsSize   _In_
Type : size_t
Taille des données de blob allouées ; elle peut être déduite de la lecture des métadonnées du blob. blobData   _Out_writes_bytes_(blobsSize)
Type : XGameSaveBlob*
Pointeur XGameSaveBlob destiné à contenir les données de blob. La mémoire allouée doit permettre de stocker tous les blobs demandés au conteneur.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Erreurs courantes

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_PROVIDED_BUFFER_TOO_SMALL
  • E_GS_BLOB_NOT_FOUND
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

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.
Utilisez cette fonction pour lire les données d’un blob de sauvegarde de jeu. La fonction renvoie le nombre de blobs et les données d’un conteneur de blobs. Vous pouvez les utiliser pour itérer sur les blobs d’un conteneur afin de lire les informations appropriées. Il existe une version asynchrone de cette fonction, appelée XGameSaveReadBlobDataAsync.

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