Skip to main content

​
XGameSaveSubmitBlobWrite

Agrega una acción de escritura a un XGameSaveUpdate.

​
Sintaxis

​
Parámetros

updateContext   _In_
Tipo: XGameSaveUpdateHandle Identificador del XGameSaveUpdate en el que se escribirá el blob. blobName   _In_z_
Tipo: char* Nombre del blob que se va a escribir. El tamaño del nombre del blob no debe ser mayor que GS_MAX_BLOB_NAME_SIZE, en bytes. data   _In_reads_bytes_(byteCount)
Tipo: uint8_t* Datos que se van a escribir en el blob. byteCount   _In_
Tipo: size_t Tamaño de los datos que se van a escribir en el blob. El tamaño de los datos del blob no debe ser mayor que GS_MAX_BLOB_SIZE, en bytes.
Aunque el tamaño de los datos del blob está limitado a GS_MAX_BLOB_SIZE, toda la actualización también está limitada a GS_MAX_BLOB_SIZE. Si una actualización contiene un blob de GS_MAX_BLOB_SIZE, las actualizaciones adicionales deben realizarse en solicitudes de actualización independientes.

​
Valor devuelto

Tipo: HRESULT Resultado de la función.

​
Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Debe llamar correctamente a XGameSaveCreateUpdate antes de realizar esta llamada. 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. Tenga en cuenta que solo puede escribir una modificación o eliminación por blob en un contexto de actualización. 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 XGameSaveSubmitUpdate. Consulte los ejemplos de XGameSaveCreateUpdate para ver su uso.

​
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
XGameSaveSubmitUpdate
XGameSaveSubmitBlobDelete
Depuración de partidas guardadas
Última modificación el 28 de agosto de 2026

Temas relacionados

XGameSaveSubmitBlobDeleteXGameSaveSubmitUpdateXGameSaveSubmitUpdateAsyncXGameSaveCreateUpdateInformación general de la API XGameSave