Skip to main content
Cette rubrique décrit comment un titre configure ses performances mémoire en version commerciale et comment activer de la mémoire de titre supplémentaire à des fins de développement.

Configuration de la mémoire du titre sur XBOX One X et le kit de développement XBOX Series X

Les titres exécutés sur XBOX One X et XBOX Series X ont accès respectivement à 8,9 Go et 13 Go de mémoire au maximum. Comme les besoins des jeux modernes peuvent varier considérablement, cette valeur est configurable par le développeur du titre. Certains jeux peuvent souhaiter un profil mémoire cohérent sur l’ensemble de la famille de consoles XBOX, tandis que d’autres peuvent avoir besoin de davantage de mémoire pour charger des textures de plus haute résolution ou effectuer des optimisations propres à XBOX One X/XBOX Series X. Vous pouvez choisir entre deux états pour la configuration de la mémoire de votre titre sur XBOX One X et XBOX Series X. Pour plus d’informations sur la configuration du mode de la console, consultez Modes de console du Microsoft Game Development Kit.

Configuration de la mémoire du titre dans MicrosoftGame.config

Dans MicrosoftGame.config, trois éléments gèrent le mode de mémoire du titre. L’élément XboxOneXTitleMemory gère le mode de mémoire du titre pour votre titre XBOX One exécuté sur une XBOX One X. Les éléments XboxLockhartTitleMemory et XboxAnacondaTitleMemory gèrent le mode de mémoire du titre pour votre titre XBOX Series X|S exécuté dans les modes « LockhartProfiling » ou « AnacondaProfiling » sur un kit de développement XBOX Series X. Les valeurs autorisées pour ces éléments sont « Standard » et « Advanced ». Pour XBOX One X, le mode Standard fournit 7,9 Go, tandis que le mode Advanced fournit 8,9 Go au titre. La différence de 1 Go n’est pas restituée au système lorsque le mode Standard est choisi : elle est affectée au cache de jeu XBOX pour améliorer les performances d’E/S du titre. Pour XBOX Series S, le mode Standard fournit 7,7 Go de mémoire. La majeure partie (7 904 Mio) est de la mémoire « GPU Optimal Bandwidth » avec une vitesse d’accès maximale de 224 Go/s, et le reste (94 Mio) est de la mémoire standard (56 Go/s). Le mode Advanced fournit 574 Mio supplémentaires, dont 128 Mio de mémoire « GPU Optimal Bandwidth ». Lorsque le mode de mémoire Standard est choisi, la différence est restituée au système afin d’éliminer la nécessité de suspendre le titre et de le reprendre rapidement dans certaines circonstances (comme l’ouverture d’une URL dans le navigateur web du système au premier plan). Pour XBOX Series X, le mode Standard fournit 10 Go de mémoire fonctionnant à la bande passante maximale disponible de 560 Go/s vers le GPU (GPU Optimal Bandwidth). Le mode Advanced donne au titre l’accès à 3 Go supplémentaires capables d’une bande passante maximale de 336 Go/s vers le GPU (Standard Bandwidth). Comme pour la XBOX One X, si le mode de mémoire Standard est choisi, la différence n’est pas restituée au système. Elle est affectée à des fonctionnalités système telles que le cache de jeu XBOX afin d’améliorer la prise en charge du titre lorsqu’il est actif.

Configuration et accès à la mémoire supplémentaire pendant le développement

Lorsque ProfilingMode est activé, de la mémoire supplémentaire est mise à la disposition de votre titre ; elle peut être utilisée pendant le développement pour tout ce qui va des outils du moteur de jeu aux ressources de jeu non optimisées. Cette mémoire supplémentaire est partagée entre le titre et les outils tels que PIX. La quantité totale de mémoire disponible lorsque ProfilingMode est activé dépend du matériel du kit de développement et, pour un kit de développement XBOX One X et un kit de développement XBOX Series X, du mode de la console. La mémoire supplémentaire est rendue visible pour le titre de deux manières :
  • Le paramètre de configuration ExtraTitleMemory peut être utilisé pour spécifier la quantité de mémoire supplémentaire mise directement à la disposition de votre titre via toutes les routines d’allocation de mémoire standard.
  • Toute mémoire non attribuée via le paramètre ExtraTitleMemory est accessible en spécifiant l’indicateur XMEM_TOOL lors de l’appel à XMemVirtualAlloc ou XMemCreateWin32Heap. Pour plus d’informations sur l’utilisation du tas XMEM_TOOL dans vos outils, consultez la section Allocation de mémoire sur le tas XMEM_TOOL ci-dessous.
Les paramètres de configuration ExtraTitleMemory peuvent être définis à l’aide de DevHome, XBOX Manager, XBOX Device Portal (Windows Device Portal sur XBOX) ou de l’outil en ligne de commande xbConfig.

Informations supplémentaires sur l’utilisation de la mémoire supplémentaire pendant le développement

  • L’utilisation de mémoire supplémentaire dans votre titre réduit la quantité de mémoire disponible pour des outils tels que PIX. Nous vous recommandons de laisser au moins 512 Mo de mémoire pour PIX.
  • Les outils s’exécutent généralement en utilisant les réservations de mémoire de la plateforme. Dans certains cas, un outil nécessite l’utilisation de la mémoire du titre. Ces allocations sont effectuées à l’aide de l’indicateur XMEM_TOOL jusqu’à ce que le pool XMEM_TOOL soit épuisé, puis elles tentent d’allouer à partir du pool de mémoire par défaut. L’indicateur ToolingMemoryOverflow peut être défini sur false pour empêcher ce débordement. Notez qu’il existe encore certains cas où PIX et d’autres outils peuvent utiliser la mémoire du titre même si vous avez spécifié le contraire à l’aide du paramètre ToolingMemoryOverflow. Ces cas seront corrigés dans une future version du GDK.
  • La modification des modes de console ne modifie pas le paramètre Profiling Mode. La mémoire supplémentaire reste disponible pour votre titre, ainsi que pour PIX et les outils. Pour désactiver la mémoire supplémentaire, désactivez Profiling Mode. Pour plus d’informations sur les modes de console, consultez Utilisation des modes de console pour tester votre jeu.

Activation de Profiling Mode

Pour accéder à la mémoire de titre supplémentaire, activez Profiling Mode dans l’onglet Performance de DevHome, l’onglet des paramètres de XBOX Manager, la page Paramètres de XBOX Device Portal (Windows Device Portal sur XBOX) ou l’outil en ligne de commande xbConfig. Dans DevHome, activez Profiling Mode à l’aide des paramètres PIX de l’onglet Performance. Si vous souhaitez que les outils débordent sur la mémoire du titre (si nécessaire), sélectionnez Allow PIX and other tools to overflow and use your game’s memory. Configuration des paramètres de mémoire étendue

Configuration de la mémoire de titre supplémentaire

Une fois Profiling Mode activé, vous pouvez configurer la quantité de mémoire supplémentaire mise directement à la disposition de votre titre et la quantité mise à disposition sur le tas XMEM_TOOL. Par défaut, aucune mémoire supplémentaire n’est mise à la disposition de votre titre. Vous pouvez modifier ce paramètre par défaut dans l’onglet Performance de DevHome, l’onglet des paramètres de XBOX Manager, la page des paramètres de XBOX Device Portal (Windows Device Portal sur XBOX) ou l’outil en ligne de commande xbConfig. Dans Dev Home, la sélection du bouton Manage tool memory dans les paramètres PIX de l’onglet Performance affiche un curseur qui vous permet de configurer la quantité de mémoire supplémentaire à accorder à votre titre : Gestion de la mémoire des outils XBOX Manager et XBOX Device Portal (Windows Device Portal sur XBOX) permettent de configurer la mémoire supplémentaire à l’aide des paramètres Additional Memory for Title et Title Memory Overflow. La spécification d’une valeur pour Additional Memory for Title augmente la mémoire du titre (et réduit la mémoire des outils) du nombre de mégaoctets indiqué. Configuration de la mémoire de titre supplémentaire Pour configurer la mémoire supplémentaire à l’aide de l’outil en ligne de commande xbConfig, utilisez les paramètres ExtraTitleMemory et ToolingMemoryOverflow.

Allocation de la mémoire des outils

L’accès à la mémoire des outils nécessite l’utilisation d’indicateurs transmis aux allocations appropriées.

XMemVirtualAlloc

XMemVirtualAlloc doit utiliser l’indicateur XMEM_TOOL.

XMemIsToolsMemAvailable / XMemCreateWin32Heap

XMemIsToolsMemAvailable / XMemCreateWin32Heap doivent utiliser l’indicateur XMEM_HEAP_TOOL.

Interrogation de la mémoire sur le tas XMEM_TOOL

L’API XMemGetWorkingSetStatistics permet d’obtenir des statistiques actuelles sur la mémoire du pool XMEM_TOOL, notamment sa taille configurée et la quantité de mémoire actuellement disponible. Pour obtenir un exemple, consultez XMemGetWorkingSetStatistics.

Voir aussi

Page Performance de Developer Home sur la console (Dev Home) Modes de console du Microsoft Game Development Kit XMemVirtualAlloc XMemGetWorkingSetStatistics
Last modified on October 6, 2026