> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSaveSubmitBlobWrite

> XGameSaveSubmitBlobWrite

# XGameSaveSubmitBlobWrite

Ajoute une action d'écriture à un XGameSaveUpdate.

## Syntaxe

```cpp theme={null}
HRESULT XGameSaveSubmitBlobWrite(  
         XGameSaveUpdateHandle updateContext,  
         const char* blobName,  
         const uint8_t* data,  
         size_t byteCount  
)  
```

### 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.

<Note>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.</Note>

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Vous devez appeler [XGameSaveCreateUpdate](/fr/reference/system/xgamesave/functions/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](/fr/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) et [XGameSaveSubmitBlobDelete](/fr/reference/system/xgamesave/functions/xgamesavesubmitblobdelete). Une mise à jour est finalisée en appelant [XGameSaveSubmitUpdate](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate).

Pour des exemples d'utilisation, consultez les [exemples XGameSaveCreateUpdate](/fr/reference/system/xgamesave/functions/xgamesavecreateupdate#example).

## 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

* [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameSave](/fr/reference/system/xgamesave/xgamesave_members)\
[XGameSaveCreateUpdate](/fr/reference/system/xgamesave/functions/xgamesavecreateupdate)\
[XGameSaveSubmitUpdate](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[XGameSaveSubmitBlobDelete](/fr/reference/system/xgamesave/functions/xgamesavesubmitblobdelete)\
[Débogage des sauvegardes de jeu](/fr/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveSubmitBlobWrite](/ko/reference/system/xgamesave/functions/xgamesavesubmitblobwrite.md)
- [XGameSaveSubmitBlobDelete](/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md)