Skip to main content

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
最后修改于 2026年8月24日