Skip to main content

XPackageInstallChunks

Démarre l’installation de blocs.

Syntaxe

Paramètres

packageIdentifier   _In_z_
Type : char*
Chaîne qui identifie de façon unique le package installé sur le disque. Pour plus d’informations sur les identificateurs de package, consultez Gérer le contenu téléchargeable (DLC) et ses licences. 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 retourne également une valeur booléenne qui indique si la taille est suffisamment grande pour qu’une invite doive être affichée. Si une confirmation de téléchargement est nécessaire, le jeu doit soit l’afficher au moyen de sa propre interface utilisateur, soit laisser XPackageInstallChunks l’afficher. queue   _In_opt_
Type : XTaskQueueHandle
File d’attente asynchrone dans laquelle le travail sera effectué. installationMonitor   _Out_
Type : XPackageInstallationMonitorHandle*
Au retour, contient un handle vers un moniteur d’installation qui surveillera l’installation des blocs correspondant au sélecteur.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.
Retourne une erreur d’annulation si l’installation est refusée.

Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
L’installation de blocs peut nécessiter de demander à l’utilisateur d’accepter la taille du téléchargement.
  • Si vous utilisez la version synchrone de cette API, elle bloquera jusqu’à ce que l’utilisateur accepte ou refuse le téléchargement. Si l’utilisateur refuse, l’appel échouera avec l’erreur d’annulation E_ABORT. Cette API retourne un moniteur d’installation que vous pouvez utiliser pour surveiller l’état de l’installation. Le moniteur doit finalement être fermé en appelant XPackageCloseInstallationMonitorHandle.
  • Affecter la valeur true à suppressUserConfirmation vous permet de fournir une interface utilisateur personnalisée qui demandera à l’utilisateur d’accepter le téléchargement.
Cet exemple installe les blocs qui correspondent à l’étiquette « BigMaps » :

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