Skip to main content

XGameSaveSubmitUpdateAsync

Envia uma atualização para o serviço XGameSave de forma assíncrona. Atualiza blobs dentro de um contêiner.

Sintaxe

Parâmetros

updateContext   _In_
Tipo: XGameSaveUpdateHandle
Um identificador para o XGameSaveUpdate a ser atualizado. async   _In_
Tipo: XAsyncBlock*
Um AsyncBlock que contém o contexto de chamada e a função de retorno de chamada para a chamada de XGameSaveSubmitUpdateAsync.

Valor retornado

Tipo: HRESULT Resultado da função

Comentários

Esta função é chamada como parte da função de chamada do AsyncBlock de XGameSaveSubmitUpdateAsync. Esta função será usada para determinar os resultados de XGameSaveSubmitUpdateAsync. A parte de armazenamento desta API foi projetada para transferir dados facilmente do jogo para o armazenamento persistente de maneira segura, confiável e transacional. Queremos garantir que os dados de suporte de um contêiner estejam sempre consistentes e, por isso, queremos que toda a operação seja bem-sucedida ou falhe atomicamente. Não queremos uma atualização parcial em que alguns dados de blob fiquem inconsistentes com outros dados dentro do contêiner. Para isso, fornecemos um contexto de atualização ao qual as gravações e exclusões de blobs são enviadas e, quando ele estiver pronto, todo o contexto é enviado. 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 XGameSaveSubmitUpdateAsync. Quando terminar de usar um XGameSaveUpdate, feche-o usando o método XGameSaveCloseUpdate. O exemplo de C++ a seguir demonstra uma atualização assíncrona do XGameSave.

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
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
Depuração de salvamentos de jogos
Last modified on October 6, 2026