XGameSaveReadBlobDataResult

检索 XGameSaveReadBlobDataAsync 调用的结果。

语法

HRESULT XGameSaveReadBlobDataResult(  
         XAsyncBlock* async,  
         size_t blobsSize,  
         XGameSaveBlob* blobData,  
         uint32_t* countOfBlobs  
)  

参数

async _In_
类型:XAsyncBlock*

传递自 XGameSaveReadBlobDataAsync 函数的 AsyncBlock。

blobsSize _In_
类型:size_t

分配的 blob 数据的所需大小。 通过 GetAsyncResultSize 检索。

blobData _Out_writes_bytes_(blobsSize)
类型:XGameSaveBlob*

用于包含 blob 数据的 XGameSaveBlob 指针。 必须分配有内存,以便存储容器中的所有 blob。

countOfBlobs _Out_
类型:uint32_t*

结果中返回的 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

备注

在完成 XGameSaveReadBlobDataAsync 后将此函数作为回调函数的一部分调用,以便确认成功和检索 XGameSaveBlob 数据以及 blob 的计数。 您可以使用这些值以便循环访问容器中的 blob,从而读取相应信息。 结果方法通常与将在以后调用它们的异步调用相一致写入,但也可以作为单独的函数写入。

有关用法,请参阅 XGameSaveReadBlobDataSync example

要求

头文件:XGameSave.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XGameSave
XGameSaveReadBlobDataAsync
XGameSaveBlobInfo
游戏保存错误