Skip to main content

​
XMemCreateWin32Heap

Cria um heap Win32.

​
Sintaxe

​
Parâmetros

HeapFlags _In_
Tipo: ULONGLONG Indica a origem da memória para o heap a ser criado. baseAddress _In_
Tipo: PVOID O endereço base para a alocação do heap in-loco. Se HeapFlags estiver definido como XMEM_HEAP_INPLACE, esse valor deverá apontar para um endereço em memória confirmada alinhado a um limite de 4 KB; caso contrário, esse valor deverá ser definido como NULL.

​
Valor retornado

Tipo: HANDLE Retorna um identificador para o heap Win32 criado, se tiver êxito; caso contrário, retorna NULL. Se estiverem disponíveis, informações de erro estendidas serão fornecidas ao retorno de chamada XErrorCallback atual do seu aplicativo.

​
Comentários

Essa função cria um heap Win32, alocando memória para o heap a partir da origem e do endereço base indicados por HeapFlags e baseAddress, respectivamente. Se XMEM_HEAP_INPLACE não tiver sido especificado em HeapFlags quando o heap foi criado, o heap será apoiado por páginas de 2 MB (ou páginas de 64 KB se XMEM_HEAP_64K_PAGES for especificado). Se ocorrer um erro ao tentar criar um heap Win32, esse método retornará NULL e, se disponível, o erro será relatado ao retorno de chamada XErrorCallback atual do seu aplicativo. Para obter mais informações sobre como lidar com casos de erro excepcionais, confira XError. Para obter mais informações sobre como configurar e acessar a memória, confira Configurando a memória para seu título e kit de desenvolvimento.

​
Alocando memória de ferramentas

Se XMEM_HEAP_TOOL for especificado em HeapFlags, a função tentará alocar memória da partição de ferramentas para criar o heap Win32, dependendo das configurações do Modo de Criação de Perfil e do Modo de Iteração:
  • Se o Modo de Iteração estiver desabilitado e o Modo de Criação de Perfil estiver habilitado, a função tentará alocar a quantidade de memória solicitada da partição de ferramentas. Se a quantidade solicitada não estiver disponível, ocorrerá um erro.
  • Se o Modo de Iteração estiver desabilitado e o Modo de Criação de Perfil estiver desabilitado, ocorrerá um erro.
  • Se o Modo de Iteração estiver habilitado, a função tentará alocar a quantidade de memória solicitada da partição do título. Se a quantidade solicitada não estiver disponível, ocorrerá um erro.
Quando o Modo de Criação de Perfil está habilitado, memória extra é disponibilizada para seu título e pode ser usada durante o desenvolvimento para qualquer coisa, desde ferramentas do mecanismo de jogo até ativos de jogo não otimizados. Para obter mais informações sobre o Modo de Criação de Perfil, confira Modo de Criação de Perfil. A partição de ferramentas não fica disponível quando o Modo de Iteração está habilitado. Você pode usar a função XMemIsToolsMemAvailable para verificar se a memória da partição de ferramentas está disponível no Modo de Criação de Perfil.

​
Requisitos

Cabeçalho: xmem.h Biblioteca: xmem.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

​
Confira também

Memória
XMem
Last modified on October 6, 2026