Skip to main content

XPackageRegisterPackageInstalled

注册一个回调,在安装完成时调用。

语法

参数

queue   _In_
类型:XTaskQueueHandle
要在其上运行回调的异步队列。 context   _In_opt_
类型:void*
要传递给回调的上下文。 callback   _In_
类型:XPackageInstalledCallback*
安装完成时调用的用户定义回调。 token   _Out_
类型:XTaskQueueRegistrationToken*
返回时,包含一个标识回调的令牌,可用于通过 XPackageUnregisterPackageInstalled 注销回调。

返回值

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

备注

PackageInstalled 通知可用于确定新包何时完全安装完成。 XPackageEnumeratePackages API 和 XPackageRegisterPackageInstalled API 都会通过 XPackageDetails 结构提供有关安装的详细信息。如果包正在安装,则 installing 属性将设为 true,你可以创建一个安装监视器,让包的标识符监视安装进度。 没有通用的安装队列通知;意图是使用 XPackageEnumeratePackages 显示和跟踪进行中的项目,并使用 PackageInstalled 宣告新 DLC 的存在。也没有停止、开始或取消安装的 API。从游戏的角度来看,安装应自行处理。错误将自动重试,且对游戏不可见。 在以下示例中,XPackageRegisterPackageInstalled 用于在安装新 DLC 包时打印一条消息:

要求

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

概念文档

另请参阅

XPackage
最后修改于 2026年8月24日