Skip to main content

XPackageUnregisterInstallationProgressChanged

注销先前注册的安装进度变化回调。

语法

参数

installationMonitor   _In_
类型:XPackageInstallationMonitorHandle
要从中移除指定回调的安装监视器。 token   _In_
类型:XTaskQueueRegistrationToken
XPackageRegisterInstallationProgressChanged 返回的令牌。 wait   _In_
类型:bool
指示是否阻塞直到所有挂起的回调完成。

返回值

类型:bool 如果 wait 为 false 且注销处于挂起状态,则返回 false。否则,返回 true。

备注

此函数在时间敏感型线程上调用不安全。有关详细信息,请参阅时间敏感型线程
通知的注销行为如下:
  • 注销从已注册的回调集中移除与令牌关联的回调。
  • 如果该回调令牌没有正在执行的回调,则调用返回 true。
  • 如果有正在执行的回调,且 wait 为 true,则调用将阻塞,直到正在执行的回调完成。
  • 如果有正在执行的回调,且 wait 为 false,则调用不会阻塞,但会返回 false。在该令牌的回调完成后,令牌会自动注销。
此机制允许以下编码模式:
  1. 你可以在注销时阻塞,以确保在调用注销后不会再调用你的回调。
  2. 你可以选择不阻塞。若要确保在删除数据之前回调已完成,请定期调用注销并将 wait 设为 false。当它最终返回 true 时,你的所有回调都已完成,你就可以删除状态。
  3. 如果你的回调不在意是否在注销调用期间被调用,则可以直接为 wait 传入 false 并忽略返回值。
示例:

要求

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

概念文档

另请参阅

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