Skip to main content

XPackageUpdateInstallationMonitor

Refreshes the progress returned from XPackageGetInstallationProgress.

Syntax

Parameters

installationMonitor   _In_
Type: XPackageInstallationMonitorHandle
The handle to the installation monitor to be updated.

Return value

Type: bool If any aspect of the progress snapshot has changed, returns true. Otherwise, returns false.

Remarks

This function isn’t safe to call on a time-sensitive thread. For more information, see Time-sensitive threads.
XPackageUpdateInstallationMonitor can be called to refresh the progress returned from XPackageGetInstallationProgress. If the installation monitor’s refresh cadence is not zero, this API will be automatically called on the refresh cadence from a timer thread. To control which thread updates the progress, set the cadence to zero and call this yourself. XPackageUpdateInstallationMonitor returns true if any aspect of the progress snapshot has changed. The following is an example of using XPackageUpdateInstallationMonitor to manually poll an installation monitor to determine whether installation of a game is completed. After installation is completed, this code closes the monitor handle.

Requirements

Header: XPackage.h Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

Conceptual documentation

See also

XPackage
Streaming Installation and Intelligent Delivery
XPackageGetInstallationProgress
Last modified on August 20, 2026