Skip to main content

XPackageGetInstallationProgress

Renvoie la progression actuelle de l’installation.

Syntaxe

Paramètres

installationMonitor   _In_
Type : XPackageInstallationMonitorHandle
Handle du moniteur d’installation. progress   _Out_
Type : XPackageInstallationProgress*
Au retour, contient la progression actuelle de l’installation.

Valeur renvoyée

Type : void

Remarques

Pour obtenir la progression actuelle d’une installation, appelez XPackageGetInstallationProgress ; pour être averti d’un changement pendant une installation, inscrivez un rappel. Vous pouvez créer le moniteur d’installation pour l’ensemble du package ou pour un sous-ensemble particulier. Pendant un bref instant lors d’une nouvelle installation de contenu, le runtime ne peut pas calculer la taille totale du package, car l’installation n’a pas complètement démarré. Dans ce cas, le runtime renvoie UINT64_MAX comme valeur de totalBytes, et zéro ou false pour tous les autres champs. Exemple :
Examinons chaque appel d’API du code ci-dessus :
Tout contenu installé possède un identificateur unique. Vous pouvez surveiller l’installation de n’importe quel package si vous connaissez l’identificateur du package et avez accès à ce contenu. Un processus en cours d’exécution peut obtenir son propre identificateur de package. Pour plus d’informations sur les identificateurs de package, consultez Gérer et accorder des licences pour le contenu téléchargeable (DLC).
Cet appel crée un moniteur qui suit l’état de l’installation. Ce moniteur d’installation se met à jour à intervalles réguliers. Pour obtenir la progression actuelle d’une installation, appelez XPackageGetInstallationProgress ; pour être averti d’un changement pendant une installation, inscrivez un rappel. Vous pouvez créer le moniteur d’installation pour l’ensemble du package ou pour un sous-ensemble particulier. Ici, vous avez défini un « sélecteur » indiquant que vous souhaitez connaître la progression de l’installation pour un nom de piste. Vous pouvez spécifier une fréquence (dans ce cas, 1 000 ms) qui indique à quelle fréquence le moniteur d’installation met à jour son instantané de la progression, jusqu’à cette vitesse. Si aucune progression n’a été réalisée dans ce délai, la mise à jour peut être plus lente.
Vous souhaitez savoir quand le chargement de la piste est terminé ; vous inscrivez donc un événement de changement de progression sur le moniteur. Ce rappel sera appelé via la file d’attente de tâches fournie lors de la création du moniteur, approximativement à la cadence spécifiée dans XPackageCreateInstallationMonitor. Dans le rappel, vous pouvez afficher la progression dans le jeu ou avertir le jeu qu’une piste est prête. Dans cet exemple, vous fermez le moniteur d’installation sans désinscrire la notification. La durée de vie d’une notification de moniteur d’installation est liée au moniteur d’installation ; par conséquent, la fermeture du moniteur désinscrit toutes les notifications qui lui sont associées.

Configuration requise

En-tête : XPackage.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XPackage
Last modified on October 6, 2026