Skip to main content

XPackageInstallChunksAsync

Démarre l’installation de blocs.

Syntaxe

Paramètres

packageIdentifier   _In_z_
Type : char*
Chaîne qui identifie de manière unique le package installé sur le disque. Pour plus d’informations sur les identificateurs de package, consultez Gérer et octroyer des licences pour le contenu téléchargeable (DLC). selectorCount   _In_
Type : uint32_t
Nombre de sélecteurs dans le paramètre selectors. selectors   _In_reads_(selectorCount)
Type : XPackageChunkSelector*
Tableau de sélecteurs qui spécifient les blocs à installer. minimumUpdateIntervalMs   _In_
Type : uint32_t
Intervalle entre les mises à jour, en millisecondes. suppressUserConfirmation   _In_
Type : bool
Si les blocs à installer dépassent une taille prédéfinie, une invite de confirmation s’affiche. Si suppressUserConfirmation a la valeur true, aucune invite ne s’affiche et l’installation se poursuit comme si l’utilisateur avait accepté. Cela permet au jeu de présenter sa propre interface utilisateur. Si le jeu utilise cette option, il doit également appeler XPackageEstimateDownloadSize pour obtenir la taille qui sera présentée à l’utilisateur. XPackageEstimateDownloadSize renvoie également un booléen indiquant si la taille est suffisamment importante pour qu’une invite soit affichée. Si une confirmation de téléchargement est nécessaire, le jeu doit soit l’afficher à l’aide de sa propre interface utilisateur, soit laisser XPackageInstallChunks l’afficher. asyncBlock   _Inout_
Type : XAsyncBlock*
XAsyncBlock permettant de surveiller l’état de l’appel asynchrone.

Valeur de retour

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

Remarques

XPackageInstallChunks possède une variante asynchrone. L’installation de blocs peut impliquer de demander à l’utilisateur d’accepter la taille du téléchargement. Cet exemple montre comment BigMaps est installé à l’aide des API asynchrones :

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
Installation en streaming et Intelligent Delivery
XPackageInstallChunks
Last modified on October 6, 2026