> ## 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](/zh-TW/reference/system/xgamesave/functions/xgamesavecreateupdate)。

此 API 的儲存部分旨在以安全、可靠且交易式的方式，輕鬆地將資料從遊戲傳輸至持續性儲存體。我們希望確保容器的備份資料始終保持一致，因此希望整個作業以不可部分完成的方式成功或失敗。我們不希望發生部分更新，導致某些 Blob 資料與容器內的其他資料不一致。為此，我們提供了一個更新內容，Blob 的寫入和刪除會提交至該內容，準備就緒後再提交整個內容。請注意，在一個更新內容中，每個 Blob 只能寫入一次修改/刪除。實際上看起來如下：

XGameSaveUpdate 會透過 [XGameSaveSubmitBlobWrite](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) 和 [XGameSaveSubmitBlobDelete](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) 填入要對容器內 Blob 執行的寫入和刪除動作。呼叫 [XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate) 即可完成更新。

如需使用方式，請參閱 [XGameSaveCreateUpdate 範例](/zh-TW/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](/zh-TW/reference/system/xgamesave/xgamesave_members)\
[XGameSaveCreateUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavecreateupdate)\
[XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[XGameSaveSubmitBlobDelete](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobdelete)\
[偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveSubmitBlobWrite](/ko/reference/system/xgamesave/functions/xgamesavesubmitblobwrite.md)
- [XGameSaveSubmitBlobDelete](/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md)