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
游戏保存错误