> ## 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. # Configuration de la mémoire pour votre titre et votre kit de développement > Configuration de la mémoire pour votre titre et votre kit de développement Cette rubrique décrit comment un titre configure ses performances de 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 les kits de développement XBOX One X et XBOX Series X Les titres qui s'exécutent sur la XBOX One X et la XBOX Series X ont accès à un maximum de 8,9 Go et de 13 Go de mémoire, respectivement. Comme les besoins des jeux modernes peuvent varier considérablement, cette valeur peut être configurée par le développeur du titre. Certains jeux peuvent souhaiter un profil de mémoire cohérent sur l'ensemble de la famille de consoles XBOX, tandis que d'autres peuvent avoir besoin de plus de mémoire pour charger des textures de plus haute résolution ou effectuer des optimisations propres à la XBOX One X/XBOX Series X. Vous pouvez choisir entre deux états pour la configuration de la mémoire de votre titre sur la XBOX One X et la XBOX Series X. | Type de console | Mode de la console | Mode de mémoire du titre | Mémoire du titre | Mémoire des outils | | :- | :-: | :-: | :-: | -: | | XBOX One/XBOX One S | | | 5 120 Mio | 1 012 Mio | | XBOX One X | | Standard
Avancé | 8 128 Mio
9 152 Mio | 2 024 Mio
1 012 Mio | | | | | | | | Kit de développement XBOX One X | XBOX One / XBOX One S | | 5 120 Mio | 5 028 Mio | | Kit de développement XBOX One X | Test XBOX One X | Standard
Avancé | 8 128 Mio
9 152 Mio | 2 024 Mio
1 012 Mio | | Kit de développement XBOX One X | Kit de développement XBOX One X \[44] | Standard
Avancé | 8 128 Mio
9 152 Mio | 14 168 Mio
13 156 Mio | | | | | | | | XBOX Series S | | Standard
Avancé | 7 998 Mio
8 572 Mio | S.O. | | XBOX Series X | | Standard
Avancé | 10 208 Mio
13 312 Mio | S.O. | | | | | | | | Kit de développement XBOX Series X | Profilage Lockhart (XBOX Series S) | Standard
Avancé | 7 998 Mio
8 572 Mio | 6 056 Mio
6 048 Mio | | Kit de développement XBOX Series X | Profilage Anaconda (XBOX Series X) | Standard
Avancé | 10 208 Mio
13 312 Mio | 9 614 Mio
15 666 Mio | | Kit de développement XBOX Series X | Scarlett 40 Go | | 37 156 Mio | | Consultez [Modes de console du Microsoft Game Development Kit](https://learn.microsoft.com/archive/console-modes-toc) pour plus d'informations sur la configuration du mode de la console. ### Configuration de la mémoire du titre dans MicrosoftGame.config Dans [MicrosoftGame.config](/fr-CA/reference/system/microsoftgameconfig/microsoftgameconfig-schema), 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 qui s'exécute 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 qui s'exécute en mode « LockhartProfiling » ou « AnacondaProfiling » sur un kit de développement XBOX Series X. Les valeurs permises pour ces éléments sont « Standard » et « Advanced ». Pour la XBOX One X, Standard fournit 7,9 Go, tandis qu'Advanced fournit 8,9 Go au titre. La différence de 1 Go n'est pas rendue au système lorsque Standard est choisi; elle est affectée au cache de jeu XBOX afin d'améliorer les performances d'E/S du titre. Pour la XBOX Series S, Standard fournit 7,7 Go de mémoire. La majeure partie (7 904 Mio) est de la mémoire « GPU Optimal Bandwidth » (bande passante optimale du GPU) offrant une vitesse d'accès maximale de 224 Go/s, et le reste (94 Mio) est de la mémoire standard (56 Go/s). Advanced fournit 574 Mio supplémentaires, dont 128 Mio en « GPU Optimal Bandwidth ». Lorsque le mode de mémoire Standard est choisi, la différence est rendue au système afin d'éliminer le besoin de suspendre et de reprendre rapidement le titre dans certaines circonstances (comme le lancement d'une URL dans le navigateur Web du système au premier plan). Pour la XBOX Series X, Standard fournit 10 Go de mémoire fonctionnant à la bande passante maximale disponible de 560 Go/s vers le GPU (GPU Optimal Bandwidth). Advanced donne au titre accès à 3 Go supplémentaires pouvant atteindre 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 rendue au système. Elle est affectée à des fonctionnalités du système comme 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 comme [PIX](/fr-CA/tools/tools-console/pix/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 façons : * Le paramètre de configuration ExtraTitleMemory peut être utilisé pour indiquer la quantité de mémoire supplémentaire mise directement à la disposition de votre titre au moyen de toutes les routines standard d'allocation de mémoire. * Toute mémoire non affectée au moyen du paramètre ExtraTitleMemory est accessible en spécifiant l'indicateur XMEM\_TOOL lors de l'appel à [XMemVirtualAlloc](/fr-CA/reference/system/xmem/functions/xmemvirtualalloc) ou à [XMemCreateWin32Heap](/fr-CA/reference/system/xmem/functions/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](/fr-CA/tools/tools-console/devhome/devhome), de [XBOX Manager](/fr-CA/tools/tools-console/xbom/xbom), du [XBOX Device Portal (Windows Device Portal sur XBOX)](/fr-CA/tools/tools-console/wdp/wdp) ou de l'outil en ligne de commande [xbConfig](/fr-CA/tools/tools-console/commandlinetools/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 comme [PIX](/fr-CA/tools/tools-console/pix/pix). Nous recommandons de laisser au moins 512 Mo de mémoire pour [PIX](/fr-CA/tools/tools-console/pix/pix). * Les outils s'exécutent généralement à l'aide des réservations de mémoire de la plateforme. Dans certains cas, un outil nécessitera l'utilisation de la mémoire du titre. Ces allocations seront effectuées à l'aide de l'indicateur XMEM\_TOOL jusqu'à ce que le pool XMEM\_TOOL soit épuisé, puis elles tenteront d'allouer à partir du pool de mémoire par défaut. L'indicateur ToolingMemoryOverflow peut être défini à false pour empêcher ce débordement. Notez qu'il existe encore certains cas où [PIX](/fr-CA/tools/tools-console/pix/pix) et d'autres outils peuvent utiliser la mémoire du titre même si vous avez indiqué qu'ils ne devaient pas le faire au moyen du paramètre ToolingMemoryOverflow. Ces cas seront corrigés dans une version future du GDK. * Le changement de mode de la console ne modifie pas le paramètre du mode de profilage. La mémoire supplémentaire demeurera disponible pour votre titre ainsi que pour PIX et les outils. Pour désactiver la mémoire supplémentaire, désactivez le mode de profilage. Consultez [Utilisation des modes de console pour tester votre jeu](/fr-CA/home/setup-install/concepts/using-console-modes) pour plus d'informations sur les modes de console. ### Activation du mode de profilage Pour accéder à la mémoire de titre supplémentaire, activez le mode de profilage dans l'onglet Performance de [DevHome](/fr-CA/tools/tools-console/devhome/devhome), l'onglet des paramètres de [XBOX Manager](/fr-CA/tools/tools-console/xbom/xbom), la page Paramètres du [XBOX Device Portal (Windows Device Portal sur XBOX)](/fr-CA/tools/tools-console/wdp/wdp) ou l'outil en ligne de commande xbConfig. Dans [DevHome](/fr-CA/tools/tools-console/devhome/devhome), activez le mode de profilage à l'aide des paramètres **PIX** de l'onglet Performance. Si vous souhaitez que les outils débordent dans la mémoire du titre (au besoin), 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 le mode de profilage 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](/fr-CA/tools/tools-console/devhome/devhome), l'onglet des paramètres de [XBOX Manager](/fr-CA/tools/tools-console/xbom/xbom), la page des paramètres du [XBOX Device Portal (Windows Device Portal sur XBOX)](/fr-CA/tools/tools-console/wdp/wdp) ou l'outil en ligne de commande [xbConfig](/fr-CA/tools/tools-console/commandlinetools/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](/fr-CA/tools/tools-console/xbom/xbom) et le [XBOX Device Portal (Windows Device Portal sur XBOX)](/fr-CA/tools/tools-console/wdp/wdp) offrent la possibilité 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 que vous indiquez. 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](/fr-CA/tools/tools-console/commandlinetools/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](/fr-CA/reference/system/xmem/functions/xmemvirtualalloc) doit utiliser l'indicateur XMEM\_TOOL. ```c++ theme={null} // Allocate 1 MB of tooling memory by using 64 K pages. PVOID cpu64kmemory = XMemVirtualAlloc (NULL, 1024 * 1024, MEM_64K_PAGES | MEM_RESERVE | MEM_COMMIT, XMEM_TOOL | XMEM_CPU, PAGE_READWRITE); ``` ### XMemIsToolsMemAvailable / XMemCreateWin32Heap [XMemIsToolsMemAvailable](/fr-CA/reference/system/xmem/functions/xmemistoolsmemavailable) / [XMemCreateWin32Heap](/fr-CA/reference/system/xmem/functions/xmemcreatewin32heap) doivent utiliser l'indicateur XMEM\_HEAP\_TOOL. ```c++ theme={null} // // XMemIsToolsMemAvailable and XMemCreateWin32Heap example. // DWORD HeapType = XMemIsToolsMemAvailable() ? XMEM_HEAP_TOOL : XMEM_HEAP_DEFAULT; // Create a dev scratch usage heap on tools or title that isn't limited in size. HANDLE ScratchHeap = XMemCreateWin32Heap(HeapType, 0); ``` ### Interrogation de la mémoire sur le tas XMEM\_TOOL L'API [XMemGetWorkingSetStatistics](/fr-CA/reference/system/xmem/functions/xmemgetworkingsetstatistics) peut être utilisée pour obtenir des statistiques actuelles sur la mémoire du pool XMEM\_TOOL, y compris sa taille configurée et la quantité de mémoire actuellement disponible. Pour un exemple, consultez [XMemGetWorkingSetStatistics](/fr-CA/reference/system/xmem/functions/xmemgetworkingsetstatistics). ## Voir aussi [Page Performance de Developer Home sur la console (Dev Home)](/fr-CA/tools/tools-console/devhome/devhome-performance) [Modes de console du Microsoft Game Development Kit](https://learn.microsoft.com/archive/console-modes-toc) [XMemVirtualAlloc](/fr-CA/reference/system/xmem/functions/xmemvirtualalloc) [XMemGetWorkingSetStatistics](/fr-CA/reference/system/xmem/functions/xmemgetworkingsetstatistics) ## Related topics - [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md) - [Compiler et exécuter votre premier titre console GDKX](/fr-CA/home/build-first-title/first-console-title-walkthrough.md) - [Documentation de développement de jeux XBOX](/fr-CA/index.md) - [Aperçu de XBOX Series X|S](/fr-CA/paths/series-xs/overview.md) - [Intégration des partenaires XBOX pour l'accès au GDK](/fr-CA/home/onboarding.md)