Skip to main content

XPackageChangeChunkInstallOrder

指定要优先安装的选定区块。

语法

参数

packageIdentifier   _In_z_
类型:char*
唯一标识磁盘上已安装程序包的字符串。有关程序包标识符的详细信息,请参阅管理和许可可下载内容 (DLC) selectorCount   _In_
类型:uint32_t
selectors 参数中的选择器数。 selectors   _In_reads_(selectorCount)
类型:XPackageChunkSelector*
指定要影响的区块类型的选择器数组。

返回值

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

备注

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
XPackageChangeChunkInstallOrder 将由指定选择器选中的区块更新为在安装队列中排在最前面。它可以接受选择器,而不仅仅是区块 ID 数组。你可以在此处传递更复杂的选择器,构成它们的所有区块都将被推到队列的前面。 你可以随时调用 XPackageChangeChunkInstallOrder,而不仅在区块尚未安装时。如果区块已经安装,XPackageChangeChunkInstallOrder 会忽略它们。如果由于智能交付的原因所提供的区块根本不计划安装,也是如此。 在下面的示例中,为了让用户继续游玩,游戏必须访问名为 “soon” 的文件。定义了函数 PrioritizeChunk,用于检查区块的当前安装状态。如果区块尚未安装,该函数会请求流式系统安装它,并返回一个可以监视区块进度的安装监视器。如果区块已经安装,该函数返回空监视器。

要求

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

概念性文档

另请参阅

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