Skip to main content

XGameSaveEnumerateBlobInfoByName

Récupère les informations de blob pour le contenu d’un XGameSaveContainer, limitées aux blobs qui partagent un préfixe avec le paramètre blobNamePrefix.

Syntaxe

Paramètres

container   _In_
Type : XGameSaveContainerHandle
Handle vers le XGameSaveContainer contenant les blobs à énumérer. blobNamePrefix   _In_opt_z_
Type : char*
préfixe utilisé pour filtrer les blobs récupérés. context   _In_opt_
Type : void*
Pointeur vers l’objet appelant, pour le contexte. callback   _In_
Type : XGameSaveBlobInfoCallback*
Fonction à appeler pour chaque blob correspondant au préfixe ; renvoyez false pour arrêter l’énumération. Utilisez-la pour itérer sur les XGameSaveBlobInfo et vérifier la réussite de l’appel de fonction.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Bien que cette fonction puisse être appelée sans risque sur un thread à durée critique, le XGameSaveBlobInfoCallback peut entraîner des retards, selon ce que fait le titre dans le rappel. Par exemple, copier des données depuis le rappel ne pose pas de problème ; en revanche, tout appel non adapté aux contraintes de temps peut retarder le retour du rappel. Pour plus d’informations, consultez Threads à durée critique.
Les blobs contiennent les données réelles récupérables qui composent un conteneur. L’énumération des blobs vous permet de voir toutes les données disponibles à l’intérieur du conteneur. Vous pouvez utiliser XGameSaveEnumerateBlobInfo pour énumérer tous les blobs d’un conteneur au lieu de filtrer par préfixe.

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