Skip to main content

XGameSaveContainerInfo

XGameSaveContainer 的相關資訊。

語法

成員

name
類型:const char*
XGameSaveContainer 的名稱。 displayName
類型:const char*
XGameSaveContainer 的顯示名稱。 blobCount
類型:uint32_t
XGameSaveContainer 中的 Blob 數目。 totalSize
類型:uint64_t
XGameSaveContainer 的總大小。 lastModifiedTime
類型:time_t
上次更新 XGameSaveContainer 的時間。 needsSync
類型:bool
布林值,指定本機與伺服器端的遊戲存檔資料之間是否有差異。
只有在您呼叫 XGameSaveInitializeProviderAsync 並將 syncOnDemand 設為 true 時,此值才會是 true。嘗試對 needsSync 為 true 的容器讀取或寫入資料,可能會導致同步 UX 顯示在遊戲上方。

備註

此結構描述 XGameSaveContainer,也可以簡稱為容器。容器保存一或多份從遊戲儲存、具有某種共同主題或用途的資料。它相當於檔案儲存系統中的資料夾。容器中會填入 XGameSaveBlob 物件,其中包含個別的資料片段。GameSave API 在容器層級提供不可部分完成的更新,因此套用的任何作業都會完全成功或完全不執行。如果您嘗試變更容器內的多個 Blob,而其中一個 Blob 更新失敗,則在作業結束時,容器中的每個 Blob 都將保持不變。您可以使用 XGameSaveEnumerateContainerInfo 或 XGameSaveEnumerateContainerInfoByName 函式來尋找遊戲的容器。XGameSaveContainerInfo 是 XGameSaveContainerInfoCallback 的參數。

需求

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

另請參閱

XGameSave
XGameSaveEnumerateContainerInfo
XGameSaveEnumerateContainerInfoByName
XGameSaveContainerInfoCallback
Last modified on October 6, 2026