Skip to main content

XPackageRegisterPackageInstalled

Inscrit un rappel à appeler lorsqu’une installation est terminée.

Syntaxe

Paramètres

queue   _In_
Type : XTaskQueueHandle
File d’attente asynchrone sur laquelle le rappel doit s’exécuter. context   _In_opt_
Type : void*
Contexte à passer au rappel. callback   _In_
Type : XPackageInstalledCallback*
Rappel défini par l’utilisateur à appeler lorsqu’une installation est terminée. token   _Out_
Type : XTaskQueueRegistrationToken*
Au retour, contient un jeton qui identifie le rappel et qui peut être utilisé pour désinscrire le rappel avec XPackageUnregisterPackageInstalled.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Les notifications PackageInstalled permettent de déterminer quand un nouveau package est entièrement installé. Les API XPackageEnumeratePackages et XPackageRegisterPackageInstalled fournissent toutes deux des détails sur une installation, par l’intermédiaire d’une structure XPackageDetails. Si le package est en cours d’installation, la propriété installing a la valeur true et vous pouvez créer un moniteur d’installation afin que l’identificateur du package surveille la progression de l’installation. Il n’existe pas de notifications génériques de file d’attente d’installation ; l’objectif est d’utiliser XPackageEnumeratePackages pour afficher et suivre les éléments en cours, et d’utiliser PackageInstalled pour annoncer la présence d’un nouveau DLC. Il n’existe pas non plus d’API pour arrêter, démarrer ou annuler une installation. Du point de vue d’un jeu, l’installation doit se gérer d’elle-même. Les erreurs font automatiquement l’objet de nouvelles tentatives et sont invisibles pour le jeu. Dans l’exemple suivant, XPackageRegisterPackageInstalled est utilisé pour afficher un message lorsqu’un nouveau package DLC est installé :

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