Skip to main content

XGameSaveSubmitUpdate

向 XGameSave 服务提交更新。更新容器内的 Blob。

语法

参数

updateContext   _In_
类型:XGameSaveUpdateHandle
要更新的 XGameSaveUpdate 的句柄。

返回值

类型:HRESULT 函数结果。 常见错误
  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_OUT_OF_LOCAL_STORAGE
  • E_GS_UPDATE_TOO_BIG
  • E_GS_QUOTA_EXCEEDED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

备注

在时间敏感线程上调用此函数并不安全。有关详细信息,请参阅时间敏感线程
在进行此调用之前,你需要成功调用 XGameSaveCreateUpdate 此 API 的存储部分旨在以安全、可靠和事务性方式将数据从游戏轻松传输到持久化存储。我们希望确保容器的支持数据始终一致,因此我们希望整个操作原子性地成功或失败。我们不希望出现部分更新的情况,即某些 Blob 数据与容器中的其他数据不一致。为此,我们提供了一个更新上下文,可以向其提交 Blob 写入和删除操作,一旦准备就绪,就会提交整个上下文。实际上,这看起来如下所示: XGameSaveUpdate 将通过 XGameSaveSubmitBlobWriteXGameSaveSubmitBlobDelete 填充要在容器内的 Blob 上执行的写入和删除操作。通过调用 XGameSaveSubmitUpdate 完成更新。 当你使用完 XGameSaveUpdate 后,使用 XGameSaveCloseUpdate 方法关闭它。 以下 C++ 示例演示了同步 XGameSave 更新。

要求

标头: XGameSave.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念性文档

另请参阅

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
XGameSaveCloseUpdate 调试游戏保存
最后修改于 2026年8月24日