> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSystemAllowFullDownloadBandwidth

> XSystemAllowFullDownloadBandwidth

# XSystemAllowFullDownloadBandwidth

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

## Syntaxe

```cpp theme={null}
void XSystemAllowFullDownloadBandwidth(  
    bool enable
)  
```

### 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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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.

<Note>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.</Note>

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.

```cpp theme={null}
void AllowFullDownloadBandwidth() 
{
    XSystemAllowFullDownloadBandwidth(true);

    // Kick off download of DLC or related package

    // Download complete or enter more active gameplay

    XSystemAllowFullDownloadBandwidth(false);
} 
```

## Configuration requise

**En-tête :** XSystem.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** consoles XBOX Series

## Documentation conceptuelle

* [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XSystem](/fr/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemAllowFullDownloadBandwidth](/reference/system/xsystem/functions/xsystemallowfulldownloadbandwidth.md)
- [XSystem](/reference/system/xsystem/xsystem_members.md)
- [GetShapeDmaBufferFull](/reference/audio/shapedmacontext/functions/getshapedmabufferfull.md)
- [XStoreDownloadPackageUpdatesResult](/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)
- [XStoreDownloadAndInstallPackagesResult](/reference/system/xstore/functions/xstoredownloadandinstallpackagesresult.md)