Skip to main content

XPackageEstimateDownloadSize

计算与指定安装选择器匹配的区块的下载大小。

语法

参数

packageIdentifier   _In_z_
类型:char*
唯一标识磁盘上已安装程序包的字符串。有关程序包标识符的详细信息,请参阅管理和许可可下载内容 (DLC) selectorCount   _In_
类型:uint32_t
selectors 参数中的选择器数。 selectors   _In_reads_(selectorCount)
类型:XPackageChunkSelector*
指定要操作的区块的选择器数组。 downloadSize   _Out_
类型:uint64_t*
返回时,包含指定安装选择器的下载大小。 shouldPresentUserConfirmation   _Out_opt_
类型:bool*
如果下载需要用户确认,则返回 true;否则返回 false。

返回值

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

备注

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
如果提供了 shouldPresentUserConfirmation 参数,则当估计的下载大小足够大以提示用户接受下载大小时,将其设置为 true。 以下示例接受赛车游戏的一个赛道名称,如果该赛道尚未安装,则打印该赛道的下载大小:

要求

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

概念性文档

另请参阅

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