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

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.
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 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 système que les ressources peuvent être récupérées. Points 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 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 système, qui peut choisir de l’ignorer s’il a besoin de ces ressources pour d’autres opérations.
Exemple d’utilisation possible : Si le jeu démarre 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 train de jouer activement. Si le joueur passe à une autre vue, le jeu doit alors désactiver cette fonctionnalité afin de garantir qu’il conserve 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