Skip to main content

​
XGameSaveEnumerateBlobInfoByName

擷取 XGameSaveContainer 內容的 Blob 資訊，僅限於與 blobNamePrefix 參數具有相同前置詞的 Blob。

​
語法

​
參數

container   _In_
類型：XGameSaveContainerHandle 包含要列舉之 Blob 的 XGameSaveContainer 控制代碼。 blobNamePrefix   _In_opt_z_
類型：char* 用來篩選所擷取 Blob 的前置詞。 context   _In_opt_
類型：void* 作為內容的呼叫物件指標。 callback   _In_
類型：XGameSaveBlobInfoCallback* 針對每個符合前置詞的 Blob 呼叫的函式，傳回 false 可停止列舉。使用此函式逐一查看 XGameSaveBlobInfo，並驗證函式呼叫是否成功。

​
傳回值

類型：HRESULT 函式結果。

​
備註

雖然在時間敏感執行緒上呼叫此函式是安全的，但 XGameSaveBlobInfoCallback 可能會造成延遲，視遊戲在回呼內執行的動作而定。例如，從回呼複製資料沒有問題；但是，執行任何非時間敏感的呼叫都可能延遲回呼的傳回。如需詳細資訊，請參閱時間敏感執行緒。
Blob 包含構成容器的實際可擷取資料。列舉 Blob 可讓您查看容器內所有可用的資料。您可以改用 XGameSaveEnumerateBlobInfo 來列舉容器的所有 Blob，而不依前置詞篩選。

​
需求

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

​
概念文件

​
另請參閱

XGameSave
XGameSaveBlobInfo
XGameSaveEnumerateBlobInfo
偵錯遊戲存檔
Last modified on October 6, 2026