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

Adiciona uma ação de gravação a um XGameSaveUpdate.

## Sintaxe

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

### Parâmetros

*updateContext*   \_In\_\
Tipo: XGameSaveUpdateHandle

Identificador para o **XGameSaveUpdate** no qual o blob será gravado.

*blobName*   \_In\_z\_\
Tipo: char\*

Nome do blob a ser gravado. O tamanho do nome do blob não deve ser maior que GS\_MAX\_BLOB\_NAME\_SIZE, em bytes.

*data*   \_In\_reads\_bytes\_(byteCount)\
Tipo: uint8\_t\*

Dados a serem gravados no blob.

*byteCount*   \_In\_\
Tipo: size\_t

Tamanho dos dados a serem gravados no blob.  O tamanho dos dados do blob não deve ser maior que GS\_MAX\_BLOB\_SIZE, em bytes.

<Note>Embora o tamanho dos dados do blob seja limitado a GS\_MAX\_BLOB\_SIZE, a atualização inteira também é limitada a GS\_MAX\_BLOB\_SIZE. Se uma atualização contiver um blob de GS\_MAX\_BLOB\_SIZE, atualizações adicionais deverão ser feitas em solicitações de atualização separadas.</Note>

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

<Note>Não é seguro chamar esta função em uma thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Você precisa chamar [XGameSaveCreateUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavecreateupdate) com êxito antes de fazer esta chamada.

A parte de armazenamento desta API foi projetada para transferir facilmente dados do jogo para o armazenamento persistente de maneira segura, confiável e transacional. Queremos garantir que os dados de suporte de um contêiner sejam sempre consistentes e, por isso, queremos que toda a operação seja bem-sucedida ou falhe atomicamente. Não queremos ter uma atualização parcial em que alguns dados de blob sejam inconsistentes com outros dados dentro do contêiner. Para fazer isso, fornecemos um contexto de atualização ao qual as gravações e exclusões de blob são enviadas e, quando estiver pronto, todo o contexto é enviado. Observe que você só pode gravar uma modificação/exclusão por blob em um contexto de atualização. Na prática, isso funciona da seguinte forma:

Um XGameSaveUpdate será preenchido com ações de gravação e exclusão a serem executadas em blobs dentro do contêiner por meio de [XGameSaveSubmitBlobWrite](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) e [XGameSaveSubmitBlobDelete](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitblobdelete). Uma atualização é concluída chamando [XGameSaveSubmitUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdate).

Confira os [exemplos de XGameSaveCreateUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavecreateupdate#example) para saber como usar.

## Requisitos

**Cabeçalho:** XGameSave.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XGameSave](/pt-BR/reference/system/xgamesave/xgamesave_members)\
[XGameSaveCreateUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavecreateupdate)\
[XGameSaveSubmitUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[XGameSaveSubmitBlobDelete](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitblobdelete)\
[Depuração de salvamentos de jogos](/pt-BR/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)