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
偵錯遊戲存檔
Last modified on October 6, 2026