Skip to main content

XGameSaveSubmitUpdateAsync

以非同步方式將更新提交至 XGameSave 服務。更新容器內的 Blob。

語法

參數

updateContext   _In_
類型:XGameSaveUpdateHandle
要更新之 XGameSaveUpdate 的控制代碼。 async   _In_
類型:XAsyncBlock*
包含 XGameSaveSubmitUpdateAsync 呼叫之呼叫內容和回呼函式的 AsyncBlock。

傳回值

類型:HRESULT 函式結果

備註

此函式會作為 XGameSaveSubmitUpdateAsync 之 AsyncBlock 呼叫函式的一部分進行呼叫。此函式將用於判斷 XGameSaveSubmitUpdateAsync 的結果。 此 API 的儲存部分旨在以安全、可靠且交易式的方式,輕鬆地將資料從遊戲傳輸到永續性儲存體。我們希望確保容器的支援資料一律保持一致,因此希望整個作業以不可部分完成的方式成功或失敗。我們不希望發生部分更新,導致某些 Blob 資料與容器內的其他資料不一致。為了達成此目的,我們提供一個更新內容,Blob 的寫入和刪除會提交至此內容,待其準備就緒時再提交整個內容。實際上看起來如下: XGameSaveUpdate 會透過 XGameSaveSubmitBlobWrite 和 XGameSaveSubmitBlobDelete,填入要對容器內 Blob 執行的寫入和刪除動作。呼叫 XGameSaveSubmitUpdateAsync 即可完成更新。 當您使用完 XGameSaveUpdate 時,請使用 XGameSaveCloseUpdate 方法將其關閉。 下列 C++ 範例示範非同步 XGameSave 更新。

需求

標頭: XGameSave.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
偵錯遊戲存檔
Last modified on October 6, 2026