XALLOC_ATTRIBUTES

Contém valores que descrevem os atributos de uma alocação de memória.

Sintaxe

typedef union _XALLOC_ATTRIBUTES {  
    ULONGLONG Attributes;  
    struct {  
        ULONGLONG ObjectType : 14;  
        ULONGLONG PageSize : 2;  
        ULONGLONG AllocatorId : 8;  
        ULONGLONG Alignment : 5;  
        ULONGLONG MemoryType : 4;  
        ULONGLONG Address32BitMapping : 1;  
        ULONGLONG reserved : 30;  
    } s;  
} XALLOC_ATTRIBUTES, *PXALLOC_ATTRIBUTES;  

Membros

Attributes
Tipo: ULONGLONG Os atributos da alocação de memória. ObjectType
Tipo: ULONGLONG O tipo de alocação, conforme definido pelo subsistema que executa a alocação de memória. Para obter mais informações, consulte ObjectType. PageSize
Tipo: ULONGLONG O tamanho de página alocado. Para obter mais informações sobre os valores permitidos, consulte PageSize. AllocatorId
Tipo: ULONGLONG A ID do alocador do subsistema que executa a alocação. Cada alocação é associada a uma ID de alocador, que identifica o subsistema que está solicitando a alocação (ou a liberação) de memória. Há três fontes potenciais de alocações: componentes de título, de plataforma e de middleware. Para obter mais informações sobre IDs de alocador, consulte XALLOC_ALLOCATOR_IDS. Alignment
Tipo: ULONGLONG O tipo de alinhamento necessário para a alocação. Para obter mais informações sobre os valores permitidos, consulte Alignment. MemoryType
Tipo: ULONGLONG O tipo de memória desejado para a alocação. Você pode escolher um dentre vários tipos de página visíveis para a GPU e comportamentos de cache, em comparação com valores úteis para alocações de memória somente da CPU. Para obter mais informações sobre os valores permitidos, consulte MemoryType. Address32BitMapping
Tipo: ULONGLONG Se definido como 1, força a alocação a obter um endereço abaixo de 4GB (exigido pela GPU, por exemplo). reserved
Tipo: ULONGLONG Reservado para uso interno.

Comentários

Essa estrutura é usada pelas definições de sintaxe de XMEMALLOC_ROUTINE e XMEMFREE_ROUTINE para, respectivamente, alocação e desalocação de memória.

O código-fonte da implementação padrão de XMemAlloc e XMemFree é instalado como parte do Microsoft Game Development Kit (GDK). Para obter mais informações, consulte as funções XMemAllocDefault e XMemFreeDefault em \GXDK\gameKit\Source\amd64\heap.c.

As seções a seguir fornecem mais informações sobre os valores permitidos e os detalhes de alocação.

ObjectType

Os valores de ObjectType são definidos pelo alocador que executa a alocação, e seu título pode usar esses valores para rastrear diferentes tipos de objeto à medida que são alocados ou para variar o comportamento do seu alocador, dependendo do tipo. Por exemplo, se você definisse um alocador para o seu sistema de partículas, poderia definir sua própria ID de alocador para o título como TitleAllocatorID_ParticleSystem e defini-la como 4, além de um pool para conter partículas que colidem apenas com o plano do chão no seu mecanismo. Esse pool poderia ter a ID de ObjectType 2, porque você já usou 0 para emissores e 1 para partículas que colidem. Tudo depende do que exatamente você deseja rastrear e de como seu mecanismo está estruturado. Como alternativa, você pode não definir IDs com uma granularidade tão grosseira; em vez disso, você pode se basear na ID do alocador para diferentes comportamentos de alocação e usar a ID de ObjectType apenas para fins de rastreamento, com cada tipo de objeto no seu jogo tendo seu próprio valor, independentemente do subsistema. O valor de ObjectType deve ser um inteiro entre 0 e 16383.

MemoryType

Você pode especificar o tipo de memória a ser alocada definindo o valor de MemoryType. O parâmetro MemoryType deve ser definido como um dos valores a seguir.

XALLOC_MEMTYPE	Valor	Descrição
XALLOC_MEMTYPE_HEAP_CACHEABLE	0x0	Indica que o bloco de memória não precisa ser visível para a GPU e deve ser armazenado em cache.
XALLOC_MEMTYPE_GRAPHICS_WRITECOMBINE	0x1	Indica que o bloco de memória está mapeado nas tabelas de páginas da GPU e deve funcionar como memória de combinação de gravação.
XALLOC_MEMTYPE_GRAPHICS_WRITECOMBINE_GPU_READONLY	0x2	Indica que o bloco de memória é somente leitura, está mapeado nas tabelas de páginas da GPU e deve funcionar como memória de combinação de gravação. Essa memória não é coerente com o cache da GPU.
XALLOC_MEMTYPE_GRAPHICS_CACHEABLE	0x3	Indica que o bloco de memória está mapeado nas tabelas de páginas da GPU e deve ser armazenado em cache e ser coerente com o cache da GPU.
XALLOC_MEMTYPE_GRAPHICS_CACHEABLE_NONCOHERENT_GPU_READONLY	0x4	Indica que o bloco de memória está mapeado nas tabelas de páginas da GPU e, embora armazenada em cache pela CPU, essa memória não é coerente com o cache da GPU. É preciso ter cuidado extra com esse tipo de memória para evitar ver linhas de cache obsoletas na CPU ou na GPU.
XALLOC_MEMTYPE_GRAPHICS_COMMAND_BUFFER_WRITECOMBINE	0x5	Indica que o bloco de memória deve ser usado como buffer de comando da GPU ou do mecanismo de DMA e deve ser de combinação de gravação. Essa memória não é coerente com o cache da GPU.
XALLOC_MEMTYPE_GRAPHICS_COMMAND_BUFFER_CACHEABLE	0x6	Indica que o bloco de memória deve ser usado como buffer de comando da GPU ou do mecanismo de DMA e deve ser armazenado em cache e ser coerente com o cache da GPU.
XALLOC_MEMTYPE_PHYSICAL_CACHEABLE	0x7	Indica que o bloco de memória é físico e armazenável em cache.
XALLOC_MEMTYPE_PHYSICAL_WRITECOMBINE	0x8	Indica que o bloco de memória é físico e deve funcionar como memória de combinação de gravação.
XALLOC_MEMTYPE_PHYSICAL_UNCACHED	0x9	Indica que o bloco de memória é físico e não armazenado em cache.
XALLOC_MEMTYPE_GRAPHICS_GPU_UNCACHED	0xA	Indica que o bloco de memória está mapeado nas tabelas de páginas da GPU. A memória é acessada sem cache pela GPU.
XALLOC_MEMTYPE_GRAPHICS_SHADER_CACHEABLE_NONCOHERENT	0xB	Indica que o bloco de memória está mapeado nas tabelas de páginas da GPU para execução de sombreador (somente leitura). A memória não é coerente com o cache da GPU.
XALLOC_MEMTYPE_GRAPHICS_EXECUTABLE_WRITECOMBINE	0xC	Indica que o bloco de memória está mapeado nas tabelas de páginas da GPU para argumentos indiretos. A memória é de combinação de gravação na CPU, executável na GPU e não coerente com o cache da GPU.

PageSize

Você pode especificar o tamanho das páginas usadas na alocação de memória definindo o valor de PageSize. Esse parâmetro pode ter um dos valores mostrados na tabela a seguir.

XALLOC_PAGESIZE	Valor	Descrição
XALLOC_PAGESIZE_4KB	0	Alocar usando páginas de 4 KB.
XALLOC_PAGESIZE_64KB	1	Alocar usando páginas de 64 KB.
XALLOC_PAGESIZE_2MB	2	Alocar usando páginas de 2 MB.

Alignment

Ao definir o valor de Alignment, seu código solicita um alinhamento específico para o bloco de memória retornado. Você também pode ver esse parâmetro como um valor de 2n, em que n é o alinhamento desejado. Ele pode ter os valores mostrados na tabela a seguir.

O alocador padrão sempre retorna um alinhamento mínimo de 16 bytes.

XALLOC_ALIGNMENT
XALLOC_ALIGNMENT_ANY
XALLOC_ALIGNMENT_4
XALLOC_ALIGNMENT_16
XALLOC_ALIGNMENT_32
XALLOC_ALIGNMENT_64
XALLOC_ALIGNMENT_128
XALLOC_ALIGNMENT_256
XALLOC_ALIGNMENT_512
XALLOC_ALIGNMENT_1K
XALLOC_ALIGNMENT_2K
XALLOC_ALIGNMENT_4K
XALLOC_ALIGNMENT_8K
XALLOC_ALIGNMENT_16K
XALLOC_ALIGNMENT_32K
XALLOC_ALIGNMENT_64K
XALLOC_ALIGNMENT_128K

Subalocação de memória não gráfica

A memória não gráfica (memória alocada usando XALLOC_MEMTYPE_HEAP_CACHEABLE) é subalocada com base no tamanho de página e no alinhamento da alocação.

Tamanho de página de 4 KB e alinhamento de 16 bytes:
- Alocações menores que 4 KB são compactadas
- Alocações maiores ou iguais a 4 KB são alinhadas a um múltiplo de 4 KB
Tamanho de página de 64 KB ou 2 MB ou um alinhamento diferente de 16 bytes:
- Alocações <= 4 KB são arredondadas para cima até um múltiplo de 256 bytes
- Alocações <= 64 KB são arredondadas para cima até um múltiplo de 2 KB
- Alocações <= 128 KB são arredondadas para cima até 128 KB
- Todas as outras alocações são arredondadas para cima até um limite de 2 MB

Requisitos

Cabeçalho: xmem.h Plataformas compatíveis: consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral da memória gráfica do GDK
XALLOC_ALLOCATOR_IDS
XMEMALLOC_ROUTINE
XMEMFREE_ROUTINE
XMem

Porting

Build Paths

XALLOC_ATTRIBUTES

XALLOC_ATTRIBUTES

Sintaxe

Membros

Comentários

ObjectType

MemoryType

PageSize

Alignment

Subalocação de memória não gráfica

Requisitos

Confira também

​XALLOC_ATTRIBUTES

​Sintaxe

​Membros

​Comentários

​ObjectType

​MemoryType

​PageSize

​Alignment

​Subalocação de memória não gráfica

​Requisitos

​Confira também

XALLOC_ATTRIBUTES

Sintaxe

Membros

Comentários

ObjectType

MemoryType

PageSize

Alignment

Subalocação de memória não gráfica

Requisitos

Confira também