Skip to main content

​
XSystemAllowFullDownloadBandwidth

Contrôle la bande passante utilisée par le téléchargement d’un package pendant l’exécution du jeu.

​
Syntaxe

​
Paramètres

enable    _In_
Type : bool Indique si la bande passante de téléchargement complète doit être activée ou désactivée.

​
Valeur de retour

Type : void

​
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.
Cette API peut être utilisée lors du téléchargement d’un package afin d’accélérer le téléchargement. Lorsqu’elle est appelée avec le paramètre défini sur true, l’API signale au système d’exploitation du système d’utiliser davantage de ressources pour le téléchargement. L’API doit être appelée de nouveau avec le paramètre défini sur false une fois le téléchargement terminé, afin de signaler au système d’exploitation du système que les ressources peuvent être récupérées. Aspects dont les développeurs doivent tenir compte lors de l’utilisation de cette API :
  • Cette API modifie les performances du processeur dans le système d’exploitation du système. Si le titre tente d’effectuer des opérations inter-VM intensives (opérations du Store, audio spatial, etc.), il peut subir une dégradation des performances. Par conséquent, cette fonctionnalité ne doit pas rester activée pendant toute la durée de vie du jeu.
Cette API envoie simplement un signal au système d’exploitation du système, et celui-ci peut choisir de l’ignorer s’il a besoin de ces ressources pour d’autres opérations.
Exemple d’utilisation possible : Si le jeu lance le téléchargement d’un DLC ou d’un autre jeu de base et qu’il affiche une barre de progression, il peut envisager d’appeler cette API pendant que le joueur se trouve sur cet écran et n’est pas en jeu actif. Si le joueur passe à une autre vue, le jeu doit alors désactiver cette fonctionnalité afin de s’assurer qu’il garde le contrôle total de sa propre bande passante réseau.

​
Configuration requise

En-tête : XSystem.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : consoles XBOX Series

​
Documentation conceptuelle

​
Voir aussi

XSystem
Last modified on October 6, 2026