Skip to main content

XGameSaveSubmitUpdateAsync

Envía de forma asincrónica una actualización al servicio XGameSave. Actualiza los blobs de un contenedor.

Sintaxis

Parámetros

updateContext   _In_
Tipo: XGameSaveUpdateHandle
Identificador del XGameSaveUpdate que se va a actualizar. async   _In_
Tipo: XAsyncBlock*
AsyncBlock que contiene el contexto de llamada y la función de devolución de llamada para la llamada a XGameSaveSubmitUpdateAsync.

Valor devuelto

Tipo: HRESULT Resultado de la función

Comentarios

Se llama a esta función como parte de la función de llamada del AsyncBlock de XGameSaveSubmitUpdateAsync. Esta función se usará para determinar los resultados de XGameSaveSubmitUpdateAsync. La parte de almacenamiento de esta API está diseñada para transferir fácilmente datos del juego al almacenamiento persistente de forma segura, fiable y transaccional. Queremos asegurarnos de que los datos de respaldo de un contenedor sean siempre coherentes y, por ello, queremos que toda la operación se realice correctamente o falle de forma atómica. No queremos tener una actualización parcial en la que algunos datos de blob sean incoherentes con otros datos del contenedor. Para ello, proporcionamos un contexto de actualización al que se envían las escrituras y eliminaciones de blobs y, cuando está listo, se envía todo el contexto. En la práctica, esto tiene el siguiente aspecto: Un XGameSaveUpdate se rellenará con acciones de escritura (Write) y eliminación (Delete) que se llevarán a cabo en los blobs del contenedor mediante XGameSaveSubmitBlobWrite y XGameSaveSubmitBlobDelete. Una actualización se completa llamando a XGameSaveSubmitUpdateAsync. Cuando termine con un XGameSaveUpdate, ciérrelo mediante el método XGameSaveCloseUpdate. En el siguiente ejemplo de C++ se muestra una actualización asincrónica de XGameSave.

Requisitos

Encabezado: XGameSave.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
Depuración de partidas guardadas
Última modificación el 28 de agosto de 2026