Skip to main content

​
XGameSaveSubmitBlobWrite

将写入操作添加到 XGameSaveUpdate。

​
语法

​
参数

updateContext   _In_
类型：XGameSaveUpdateHandle 将写入 Blob 的 XGameSaveUpdate 的句柄。 blobName   _In_z_
类型：char* 要写入的 Blob 的名称。Blob 名称的大小（以字节为单位）不应大于 GS_MAX_BLOB_NAME_SIZE。 data   _In_reads_bytes_(byteCount)
类型：uint8_t* 要写入 Blob 的数据。 byteCount   _In_
类型：size_t 要写入 Blob 的数据的大小。Blob 数据的大小（以字节为单位）不应大于 GS_MAX_BLOB_SIZE。
虽然 Blob 数据的大小限制为 GS_MAX_BLOB_SIZE，但整个更新也限制为 GS_MAX_BLOB_SIZE。如果更新包含大小为 GS_MAX_BLOB_SIZE 的 Blob，则必须在单独的更新请求中进行其他更新。

​
返回值

类型：HRESULT 函数结果。

​
备注

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

​
要求

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

​
概念性文档

​
另请参阅

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

相关主题

XGameSaveSubmitBlobDeleteXGameSaveSubmitUpdateXGameSaveSubmitUpdateAsyncXGameSaveCreateUpdateXGameSave API 概述