通过

XPackageUpdateInstallationMonitor

  • 项目

刷新从 XPackageGetInstallationProgress 返回的进度。

语法

bool XPackageUpdateInstallationMonitor(  
         XPackageInstallationMonitorHandle installationMonitor  
)

参数

installationMonitor _In_
类型：XPackageInstallationMonitorHandle

要更新的安装监视器的句柄。

返回值

类型：bool

如果进度快照的任何方面已更改，则返回 true。 否则返回 false。

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。

可以调用 XPackageUpdateInstallationMonitor 以刷新从 XPackageGetInstallationProgress 返回的进度。 如果安装监视器的刷新频率为非零值，将针对计时器线程的刷新频率自动调用此 API。 控制由哪个线程更新进度，请将频率设置为零并自行调用此函数。 如果进度快照的任何方面已更改，则 XPackageUpdateInstallationMonitor 返回 true。

下面是使用 XPackageUpdateInstallationMonitor 手动轮询安装监视器以确定是否已完成游戏安装的示例。 安装完成后，此代码将关闭监视器句柄。

bool CheckIfInstalled(XPackageInstallationMonitorHandle monitor)
{
    XPackageInstallationProgress progress;
    XPackageGetInstallationProgress(monitor, &progress);

    if (!progress.completed && XPackageUpdateInstallationMonitor(monitor))
    {
        XPackageGetInstallationProgress(monitor, &progress);
    }

    if (progress.completed)
    {
        XPackageCloseInstallationMonitorHandle(monitor);
    }

    return progress.completed;
}

要求

头文件：XPackage.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XPackage
流式安装和智能交付
XPackageGetInstallationProgress