Skip to main content

XGameSaveSubmitUpdateAsync

以异步方式向 XGameSave 服务提交更新。更新容器内的 Blob。

语法

参数

updateContext   _In_
类型:XGameSaveUpdateHandle
要更新的 XGameSaveUpdate 的句柄。 async   _In_
类型:XAsyncBlock*
包含 XGameSaveSubmitUpdateAsync 调用的调用上下文和回调函数的 AsyncBlock。

返回值

类型:HRESULT 函数结果

备注

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

要求

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

概念性文档

另请参阅

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