> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSaveSubmitBlobWrite

> XGameSaveSubmitBlobWrite

# XGameSaveSubmitBlobWrite

将写入操作添加到 XGameSaveUpdate。

## 语法

```cpp theme={null}
HRESULT XGameSaveSubmitBlobWrite(  
         XGameSaveUpdateHandle updateContext,  
         const char* blobName,  
         const uint8_t* data,  
         size_t byteCount  
)  
```

### 参数

*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。

<Note>虽然 Blob 数据的大小限制为 GS\_MAX\_BLOB\_SIZE，但整个更新也限制为 GS\_MAX\_BLOB\_SIZE。如果更新包含大小为 GS\_MAX\_BLOB\_SIZE 的 Blob，则必须在单独的更新请求中进行其他更新。</Note>

### 返回值

类型：HRESULT

函数结果。

## 备注

<Note>在时间敏感线程上调用此函数并不安全。有关详细信息，请参阅[时间敏感线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

在进行此调用之前，你需要成功调用 [XGameSaveCreateUpdate](/reference/system/xgamesave/functions/xgamesavecreateupdate)。

此 API 的存储部分旨在以安全、可靠和事务性方式将数据从游戏轻松传输到持久化存储。我们希望确保容器的支持数据始终一致，因此我们希望整个操作原子性地成功或失败。我们不希望出现部分更新的情况，即某些 Blob 数据与容器中的其他数据不一致。为此，我们提供了一个更新上下文，可以向其提交 Blob 写入和删除操作，一旦准备就绪，就会提交整个上下文。请注意，在一个更新上下文中，每个 Blob 只能写入一个修改/删除操作。实际上，这看起来如下所示：

XGameSaveUpdate 将通过 [XGameSaveSubmitBlobWrite](/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) 和 [XGameSaveSubmitBlobDelete](/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) 填充要在容器内的 Blob 上执行的写入和删除操作。通过调用 [XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate) 完成更新。

有关用法，请参阅 [XGameSaveCreateUpdate 示例](/reference/system/xgamesave/functions/xgamesavecreateupdate#example)。

## 要求

**标头：** XGameSave.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 概念性文档

* [时间敏感线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另请参阅

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveCreateUpdate](/reference/system/xgamesave/functions/xgamesavecreateupdate)\
[XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[XGameSaveSubmitBlobDelete](/reference/system/xgamesave/functions/xgamesavesubmitblobdelete)\
[调试游戏保存](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveSubmitBlobDelete](/zh-CN/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md)
- [XGameSaveSubmitUpdate](/zh-CN/reference/system/xgamesave/functions/xgamesavesubmitupdate.md)
- [XGameSaveSubmitUpdateAsync](/zh-CN/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md)
- [XGameSaveCreateUpdate](/zh-CN/reference/system/xgamesave/functions/xgamesavecreateupdate.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)