Skip to main content

XGameSaveReadBlobData

讀取容器的 Blob 資料。

語法

參數

container   _In_
類型:XGameSaveContainerHandle
包含 XGameSaveBlob 資料的 XGameSaveContainer 控制代碼。 blobNames   _In_opt_z_count_(countOfBlobs)
類型:char
*
指向代表 XGameSaveBlob 名稱之字串陣列的指標。 countOfBlobs   _Inout_
類型:uint32_t*
要讀取的 Blob 數目。 blobsSize   _In_
類型:size_t
已配置之 Blob 資料的大小,可從讀取 Blob 中繼資料推斷。 blobData   _Out_writes_bytes_(blobsSize)
類型:XGameSaveBlob*
用來包含 Blob 資料的 XGameSaveBlob 指標。必須已配置記憶體,以儲存從容器要求的所有 Blob。

傳回值

類型:HRESULT 函式結果。

常見錯誤

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_PROVIDED_BUFFER_TOO_SMALL
  • E_GS_BLOB_NOT_FOUND
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
使用此函式讀取遊戲存檔 Blob 中的資料。此函式會傳回 Blob 的數目以及 Blob 容器內的資料。您可以使用這些值逐一查看容器中的 Blob,以讀取適當的資訊。此函式有一個非同步版本,稱為 XGameSaveReadBlobDataAsync。

需求

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

概念文件

另請參閱

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