Skip to main content

XPackageFindChunkAvailability

返回与指定选择器匹配的区块集合的最低可用性。

语法

参数

packageIdentifier   _In_z_
类型:char*
唯一标识磁盘上已安装程序包的字符串。有关程序包标识符的详细信息,请参阅管理和许可可下载内容 (DLC) selectorCount   _In_
类型:uint32_t
selectors 参数中的选择器数。 selectors   _In_reads_opt_(selectorCount)
类型:XPackageChunkSelector*
指定要检查的区块的选择器数组。 availability   _Out_
类型:XPackageChunkAvailability*
返回时,列出区块的可用性。

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
XPackageFindChunkAvailability 接受一个区块选择器数组,查找相关的区块,然后返回这些区块的最低可用性。可用性根据以下值分级:
  • Ready:区块已安装并可读取。
  • Pending:区块尚未安装,但即将安装。
  • Installable:区块不会被安装,但可以下载。
  • Unavailable:区块无法下载。
以下示例接受赛车游戏的一个赛道名称,如果该赛道尚未安装,则打印该赛道的下载大小:

要求

头文件: XPackage.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念性文档

另请参阅

XPackage
流式安装和智能交付
最后修改于 2026年8月24日