Skip to main content
Este tópico descreve como um título configura o desempenho de memória de varejo e como habilitar memória de título adicional para fins de desenvolvimento.

Configurar a memória do título no XBOX One X e no kit de desenvolvimento XBOX Series X

Os títulos executados no XBOX One X e no XBOX Series X têm acesso a até 8,9 GB e 13 GB de memória, respectivamente. Como as necessidades dos jogos modernos podem variar muito, esse valor pode ser configurado pelo desenvolvedor do título. Alguns jogos podem querer um perfil de memória consistente em toda a família de consoles XBOX, e outros podem precisar de mais memória para carregar texturas de resolução mais alta ou realizar otimizações específicas do XBOX One X/XBOX Series X. Você pode escolher entre dois estados para a configuração de memória do seu título no XBOX One X e no XBOX Series X. Consulte Modos de console do Microsoft Game Development Kit para obter mais informações sobre como configurar o modo do console.

Configurar a memória do título no MicrosoftGame.config

No MicrosoftGame.config, há três elementos que gerenciam o modo de memória do título. O elemento XboxOneXTitleMemory gerencia o modo de memória do título para seu título do XBOX One executado em um XBOX One X. Os elementos XboxLockhartTitleMemory e XboxAnacondaTitleMemory gerenciam o modo de memória do título para seu título do XBOX Series X|S executado nos modos “LockhartProfiling” ou “AnacondaProfiling” em um kit de desenvolvimento XBOX Series X. Os valores permitidos para esses elementos são “Standard” e “Advanced”. No XBOX One X, Standard fornece 7,9 GB, enquanto Advanced fornece 8,9 GB ao título. A diferença de 1 GB não é devolvida ao sistema quando Standard é escolhido; ela é aplicada ao cache de jogos do XBOX para aumentar o desempenho de E/S do título. No XBOX Series S, Standard fornece 7,7 GB de memória. A maior parte (7904 MiB) é memória “GPU Optimal Bandwidth”, com velocidade de acesso máxima de 224 GB/s, e o restante (94 MiB) é padrão (56 GB/s). Advanced fornece 574 MiB adicionais, sendo 128 MiB “GPU Optimal Bandwidth”. Quando o modo de memória Standard é escolhido, a diferença é devolvida ao sistema para eliminar a necessidade de suspender e retomar rapidamente o título em determinadas circunstâncias (como ao abrir uma URL no navegador da Web do sistema em primeiro plano). No XBOX Series X, Standard fornece 10 GB de memória operando com a largura de banda máxima disponível de 560 GB/s para a GPU (GPU Optimal Bandwidth). Advanced dá ao título acesso a 3 GB adicionais, capazes de uma largura de banda máxima de 336 GB/s para a GPU (Standard Bandwidth). Assim como no XBOX One X, se o modo de memória Standard for escolhido, a diferença não é devolvida ao sistema. Ela é aplicada a recursos do sistema, como o cache de jogos do XBOX, para aprimorar o suporte ao título quando ele está ativo.

Configurar e acessar memória adicional durante o desenvolvimento

Quando o ProfilingMode está habilitado, memória adicional é disponibilizada para seu título e pode ser usada durante o desenvolvimento para qualquer finalidade, de ferramentas do mecanismo de jogo a ativos de jogo não otimizados. Essa memória adicional é compartilhada entre o título e ferramentas como o PIX. A quantidade total de memória disponível quando o ProfilingMode está habilitado depende do hardware do kit de desenvolvimento e, no caso de um kit de desenvolvimento XBOX One X e de um kit de desenvolvimento XBOX Series X, do modo do console. A memória adicional fica visível para o título de duas maneiras:
  • A configuração ExtraTitleMemory pode ser usada para especificar quanta memória adicional é disponibilizada diretamente para seu título por meio de todas as rotinas padrão de alocação de memória.
  • Qualquer memória não atribuída pela configuração ExtraTitleMemory pode ser acessada especificando o sinalizador XMEM_TOOL ao chamar XMemVirtualAlloc ou XMemCreateWin32Heap. Para obter mais informações sobre como usar o heap XMEM_TOOL em suas ferramentas, consulte a seção Alocar memória no heap XMEM_TOOL a seguir.
As configurações de ExtraTitleMemory podem ser definidas usando o DevHome, o XBOX Manager, o XBOX Device Portal (Windows Device Portal no XBOX) ou a ferramenta de linha de comando xbConfig.

Informações adicionais sobre o uso de memória adicional durante o desenvolvimento

  • Usar memória adicional no seu título reduz a quantidade de memória disponível para ferramentas como o PIX. Recomendamos deixar pelo menos 512 MB de memória para o PIX.
  • Em geral, as ferramentas são executadas usando as reservas de memória da plataforma. Em alguns casos, uma ferramenta exigirá o uso de memória do título. Essas alocações serão feitas usando o sinalizador XMEM_TOOL até que o pool XMEM_TOOL se esgote e, então, tentarão alocar do pool de memória padrão. O sinalizador ToolingMemoryOverflow pode ser definido como false para evitar esse transbordamento. Observe que ainda há alguns casos em que o PIX e outras ferramentas podem usar memória do título mesmo que você tenha especificado que isso não deve acontecer usando a configuração ToolingMemoryOverflow. Esses casos serão corrigidos em uma versão futura do GDK.
  • Alterar os modos de console não altera a configuração do modo de criação de perfil. A memória adicional continuará disponível para seu título, para o PIX e para as ferramentas. Para desativar a memória adicional, desative o modo de criação de perfil. Consulte Usar modos de console para testar seu jogo para obter mais informações sobre os modos de console.

Ativar o modo de criação de perfil

Para acessar a memória de título adicional, ative o modo de criação de perfil na guia Desempenho do DevHome, na guia de configurações do XBOX Manager, na página Configurações do XBOX Device Portal (Windows Device Portal no XBOX) ou na ferramenta de linha de comando xbConfig. No DevHome, ative o modo de criação de perfil usando as configurações do PIX na guia Desempenho. Se você quiser que as ferramentas transbordem para a memória do título (se necessário), selecione Allow PIX and other tools to overflow and use your game’s memory. Definir as configurações de memória estendida

Configurar a memória de título adicional

Depois que o modo de criação de perfil for ativado, você poderá configurar quanta memória adicional é disponibilizada diretamente para seu título e quanta é disponibilizada no heap XMEM_TOOL. Por padrão, nenhuma memória adicional é disponibilizada para seu título. Você pode alterar essa configuração padrão na guia Desempenho do DevHome, na guia de configurações do XBOX Manager, na página de configurações do XBOX Device Portal (Windows Device Portal no XBOX) ou na ferramenta de linha de comando xbConfig. No Dev Home, selecionar o botão Manage tool memory nas configurações do PIX na guia Desempenho exibe um controle deslizante que permite configurar quanta memória adicional fornecer ao seu título: Gerenciar a memória de ferramentas O XBOX Manager e o XBOX Device Portal (Windows Device Portal no XBOX) expõem a capacidade de configurar memória adicional usando as configurações Additional Memory for Title e Title Memory Overflow. Especificar um valor para Additional Memory for Title expande a memória do título (e reduz a memória de ferramentas) pelo número de megabytes indicado. Configurar memória de título adicional Para configurar memória adicional usando a ferramenta de linha de comando xbConfig, use as configurações ExtraTitleMemory e ToolingMemoryOverflow.

Alocar memória de ferramentas

O acesso à memória de ferramentas exige o uso de sinalizadores passados para as alocações apropriadas.

XMemVirtualAlloc

XMemVirtualAlloc deve usar o sinalizador XMEM_TOOL.

XMemIsToolsMemAvailable / XMemCreateWin32Heap

XMemIsToolsMemAvailable / XMemCreateWin32Heap devem usar o sinalizador XMEM_HEAP_TOOL.

Consultar a memória no heap XMEM_TOOL

A API XMemGetWorkingSetStatistics pode ser usada para obter estatísticas atuais sobre a memória no pool XMEM_TOOL, incluindo seu tamanho configurado e a quantidade de memória disponível no momento. Para ver um exemplo, consulte XMemGetWorkingSetStatistics.

Confira também

Página Desempenho do Developer Home no console (Dev Home) Modos de console do Microsoft Game Development Kit XMemVirtualAlloc XMemGetWorkingSetStatistics
Last modified on October 6, 2026