> ## 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.

# AllocateFromCommandAllocatorX

> Referência para AllocateFromCommandAllocatorX, um método da API gráfica Direct3D 12 dos consoles XBOX Series. Reservado ou não utilizado no XBOX; consulte os comentários para obter detalhes.

Aloca memória com o mesmo tempo de vida da lista de comandos associada. Isso pode ser usado para preparar dados na linha do tempo da CPU a serem lidos na linha do tempo da GPU, como para entradas dinâmicas de shader.

## Sintaxe

```cpp theme={null}
void* AllocateFromCommandAllocatorX(  
         UINT sizeBytes,  
         UINT alignmentBytes  
)  
```

### Parâmetros

*sizeBytes*   \_In\_\
Tipo: UINT

Tamanho da alocação em bytes.

*alignmentBytes*   \_In\_\
Tipo: UINT

Alinhamento mínimo da alocação em bytes.

### Valor retornado

Tipo: void\*

O endereço da memória alocada. Este é um ponteiro de GPU válido e pode ser convertido em D3D12\_GPU\_VIRTUAL\_ADDRESS.

Se não houver memória disponível, nullptr será retornado.

Cuidado: a memória pode ser de gravação combinada (write combined) e não armazenada em cache da CPU. Leituras pela CPU devem ser evitadas.

## Requisitos

**Cabeçalho:** d3d12\_xs.h

**Biblioteca:** d3d12\_xs.lib

**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList8](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList8/id3d12graphicscommandlist8)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CreateCommandAllocator](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandallocator_public.md)
- [ID3D12CommandAllocator::Reset](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandallocator/methods/id3d12commandallocator_reset_public.md)
- [XALLOC_ALLOCATOR_IDS](/pt-BR/reference/system/xmem/enums/xalloc_allocator_ids.md)
- [CreateCommandList](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandlist_public.md)