Skip to main content

XPackageChangeChunkInstallOrder

Spécifie quels blocs sélectionnés doivent être installés en premier.

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 accorder 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écifie le type de blocs concernés.

Valeur renvoyée

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

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à contrainte de temps. Pour plus d’informations, consultez Threads à contrainte de temps.
XPackageChangeChunkInstallOrder place les blocs sélectionnés par le sélecteur spécifié en tête de la file d’attente d’installation. Cette fonction accepte un sélecteur, et pas seulement un tableau d’ID de blocs. Vous pouvez transmettre ici des sélecteurs plus complexes, et les blocs qui les composent seront tous placés en tête de la file d’attente. Vous pouvez appeler XPackageChangeChunkInstallOrder à tout moment, et pas uniquement lorsque les blocs ne sont pas installés. Si les blocs sont déjà installés, XPackageChangeChunkInstallOrder les ignore. Il en va de même lorsque vous fournissez des blocs qui, en raison d’Intelligent Delivery, ne sont pas du tout prévus pour être installés. Dans l’exemple suivant, pour que l’utilisateur puisse continuer à jouer, le jeu doit accéder à un fichier appelé « soon ». La fonction PrioritizeChunk est définie et vérifie l’état d’installation actuel du bloc. Si le bloc n’est pas encore installé, la fonction demande au système de streaming de l’installer et renvoie un moniteur d’installation capable de surveiller la progression du bloc. Si le bloc est déjà installé, la fonction renvoie un moniteur null.

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
Last modified on October 6, 2026