通过

XGameSaveEnumerateBlobInfoByName

  • 项目

检索限制到与 blobNamePrefix 参数共享某一前缀的 blob 的 XGameSaveContainer 内容的 blob 信息。

语法

HRESULT XGameSaveEnumerateBlobInfoByName(  
         XGameSaveContainerHandle container,  
         const char* blobNamePrefix,  
         void* context,  
         XGameSaveBlobInfoCallback* callback  
)

参数

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