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

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

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

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

Consultez les [exemples XGameSaveCreateUpdate](/fr-CA/reference/system/xgamesave/functions/xgamesavecreateupdate#example) 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

* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameSave](/fr-CA/reference/system/xgamesave/xgamesave_members)\
[XGameSaveCreateUpdate](/fr-CA/reference/system/xgamesave/functions/xgamesavecreateupdate)\
[XGameSaveSubmitUpdate](/fr-CA/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[XGameSaveSubmitBlobDelete](/fr-CA/reference/system/xgamesave/functions/xgamesavesubmitblobdelete)\
[Débogage des sauvegardes de jeu](/fr-CA/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)