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
调试游戏保存
最后修改于 2026年8月24日