Skip to main content

XPackageInstallChunks

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. queue   _In_opt_
Type : XTaskQueueHandle
File d’attente asynchrone sur 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.
Renvoie une erreur d’annulation si l’installation est refusée.

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
L’installation de blocs peut impliquer de demander à l’utilisateur d’accepter la taille du téléchargement.
  • Si vous utilisez la version synchrone de cette API, elle reste bloquée jusqu’à ce que l’utilisateur accepte ou refuse le téléchargement. Si l’utilisateur refuse, l’appel échoue avec l’erreur d’annulation E_ABORT. Elle renvoie un moniteur d’installation que vous pouvez utiliser pour surveiller l’état de l’installation. Le moniteur doit finalement être fermé en appelant XPackageCloseInstallationMonitorHandle.
  • Définir suppressUserConfirmation sur true vous permet de fournir une interface utilisateur personnalisée qui demandera à l’utilisateur de confirmer le téléchargement.
Cet exemple installe les blocs qui correspondent à la balise « 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