XGameSaveSubmitUpdateAsync
Submit an update to the XGameSave service asynchronously. Updates blobs within a container.Syntax
Parameters
updateContext _In_Type: XGameSaveUpdateHandle A handle to the XGameSaveUpdate to be updated. async _In_
Type: XAsyncBlock* An AsyncBlock containing the calling context and callback function for the XGameSaveSubmitUpdateAsync call.
Return value
Type: HRESULT Function resultRemarks
This function is called as a part of the AsyncBlock call function of XGameSaveSubmitUpdateAsync. This function will be used to determine the results of XGameSaveSubmitUpdateAsync. The storage portion of this API is designed to easily transfer data from the game to persisted storage in a safe, reliable and transactional manner. We want to make sure the backing data for a container is always consistent and as such we want the whole operation to succeed or fail atomically. We don’t want to have a partial update where some blob data is inconsistent with other data within the container. In order to do this we provide an update context that blob writes and deletes are submitted to and when that is ready the whole context is submitted. In practice this looks like the following: An XGameSaveUpdate will be filled with Write and Delete actions to be carried out on blobs within the container by way of XGameSaveSubmitBlobWrite and XGameSaveSubmitBlobDelete. An update is completed by calling XGameSaveSubmitUpdateAsync. When you are finished with an XGameSaveUpdate close it using the XGameSaveCloseUpdate method. The following C++ sample demonstrates an asynchronous XGameSave update.Requirements
Header: XGameSave.h Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consolesConceptual documentation
See also
XGameSaveXGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
Debugging Game Saves
