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 主机概念性文档
另请参阅
XGameSaveXGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
调试游戏保存
