通过

XGameSaveContainerInfo

  • 项目

有关 XGameSaveContainer 的信息。

语法

typedef struct XGameSaveContainerInfo {  
    const char* name;  
    const char* displayName;  
    uint32_t blobCount;  
    uint64_t totalSize;  
    time_t lastModifiedTime;  
    bool needsSync;  
} XGameSaveContainerInfo

成员

name
类型：const char*

XGameSaveContainer 的名称。

displayName
类型：const char*

XGameSaveContainer 的显示名称。

blobCount
类型：uint32_t

XGameSaveContainer 中 blob 的数目。

totalSize
类型：uint64_t

XGameSaveContainer 的总大小。

lastModifiedTime
类型：time_t

上次更新了 XGameSaveContainer。

needsSync
类型：bool

一个布尔值，它指定本地和服务器端游戏保存数据之间是否存在区别。

注意

只有将 syncOnDemand 设置为 true 的情况下调用 XGameSaveInitializeProviderAsync，该值才将是 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