Skip to main content

XGameSaveSubmitBlobDelete

將刪除動作新增至遊戲存檔 XGameSaveUpdate。

語法

參數

updateContext   _In_
類型:XGameSaveUpdateHandle
將在其中刪除 Blob 的 XGameSaveUpdate 控制代碼。 blobName   _In_z_
類型:char*
要刪除的 Blob 名稱。

傳回值

類型:HRESULT 函式結果

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
進行此呼叫之前,您必須先成功呼叫 XGameSaveCreateUpdate。 此 API 的儲存部分旨在以安全、可靠且交易式的方式,輕鬆地將資料從遊戲傳輸至持續性儲存體。我們希望確保容器的備份資料始終保持一致,因此希望整個作業以不可部分完成的方式成功或失敗。我們不希望發生部分更新,導致某些 Blob 資料與容器內的其他資料不一致。為此,我們提供了一個更新內容,Blob 的寫入和刪除會提交至該內容,準備就緒後再提交整個內容。實際上看起來如下: XGameSaveUpdate 會透過 XGameSaveSubmitBlobWrite 和 XGameSaveSubmitBlobDelete 填入要對容器內 Blob 執行的寫入和刪除動作。呼叫 XGameSaveSubmitUpdate 即可完成更新。 如需使用方式,請參閱 XGameSaveCreateUpdate 範例。

需求

標頭: XGameSave.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitUpdate
XGameSaveSubmitBlobWrite
偵錯遊戲存檔
Last modified on October 6, 2026