Passer au contenu principal

XPackageChangeChunkInstallOrder

Spécifie les blocs sélectionnés à installer en premier.

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

Valeur de retour

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

Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
XPackageChangeChunkInstallOrder met à jour les blocs sélectionnés par le sélecteur spécifié afin qu’ils soient placés en premier dans la file d’attente d’installation. Cette fonction peut accepter un sélecteur, et pas seulement un tableau d’ID de blocs. Vous pouvez passer 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 seulement 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 déjà installé, la fonction demande au système de diffusion en continu de l’installer et retourne un moniteur d’installation qui peut suivre la progression du bloc. Si le bloc est déjà installé, la fonction retourne 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 continu et Intelligent Delivery
Dernière modification le 6 octobre 2026