XPackageInstallChunks
启动区块的安装。语法
参数
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 显示它。 queue _In_opt_
类型:XTaskQueueHandle 将执行工作的异步队列。 installationMonitor _Out_
类型:XPackageInstallationMonitorHandle* 返回时,包含一个安装监视器的句柄,该监视器将监视与选择器匹配的区块的安装。
返回值
类型:HRESULT HRESULT 成功或错误代码。 如果安装被拒绝,则返回取消错误。备注
此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程。
- 如果你使用此 API 的同步版本,它将阻塞直到用户接受或拒绝下载。如果用户拒绝,则调用将失败并返回取消错误 E_ABORT。这将返回一个安装监视器,你可以使用它来监视安装状态。监视器最终必须通过调用 XPackageCloseInstallationMonitorHandle 来关闭。
- 将 suppressUserConfirmation 设置为 true 将允许你提供一个自定义 UI,用于提示用户进行下载。
