Skip to main content

​
XGameSaveSubmitBlobWrite

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

​
Sintaxe

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

​
Valor retornado

Tipo: HRESULT Resultado da função.

​
Comentários

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.
Você precisa chamar 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 e XGameSaveSubmitBlobDelete. Uma atualização é concluída chamando XGameSaveSubmitUpdate. Confira os exemplos de XGameSaveCreateUpdate 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

​
Confira também

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitUpdate
XGameSaveSubmitBlobDelete
Depuração de salvamentos de jogos
Last modified on October 6, 2026