XPackageInstallChunksAsync
启动区块的安装。语法
参数
packageIdentifier _In_z_类型:char* 用于在磁盘上唯一标识已安装包的字符串。有关包标识符的详细信息,请参阅管理和授权可下载内容 (DLC)。 selectorCount _In_
类型:uint32_t selectors 参数中的选择器数量。 selectors _In_reads_(selectorCount)
类型:XPackageChunkSelector* 一个选择器数组,用于指定要安装的区块。 minimumUpdateIntervalMs _In_
类型:uint32_t 更新之间的间隔时间(以毫秒为单位)。 suppressUserConfirmation _In_
类型:bool 如果待安装的区块超过预设大小,则会显示确认提示。如果 suppressUserConfirmation 为 true,则不会显示提示,安装将像用户已接受一样继续进行。这样,游戏就可以呈现自己的 UI。如果游戏使用此参数,还应调用 XPackageEstimateDownloadSize 以获取将向用户显示的大小。XPackageEstimateDownloadSize 还会返回一个布尔值,用于指示大小是否已达到需要显示提示的程度。如果需要下载确认,则游戏必须使用自己的 UI 显示确认,或让 XPackageInstallChunks 显示确认。 asyncBlock _Inout_
类型:XAsyncBlock* 用于监视异步调用状态的 XAsyncBlock。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
XPackageInstallChunks 有一个异步变体。区块的安装可能需要提示用户接受下载大小。 此示例展示了如何使用异步 API 安装 BigMaps:要求
头文件: XPackage.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XPackage流式安装和智能交付
XPackageInstallChunks
