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

# CreateCommandAllocator

> Cria um objeto alocador de comandos.

Cria um objeto alocador de comandos.

## Sintaxe

```cpp theme={null}
HRESULT CreateCommandAllocator(
    D3D12_COMMAND_LIST_TYPE type,
    const IID & riid,
    void  ppCommandAllocator
)
```

### Parâmetros

*type \[in]*\
Tipo: D3D12\_COMMAND\_LIST\_TYPE

Um valor do tipo [D3D12\_COMMAND\_LIST\_TYPE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_command_list_type) que especifica o tipo de alocador de comandos a ser criado.
O tipo de alocador de comandos pode ser o tipo que registra listas de comandos diretas ou pacotes.

*riid*\
Tipo: const IID &

O identificador global exclusivo (**GUID**) da interface do alocador de comandos ([ID3D12CommandAllocator](/pt-BR/reference/graphics/d3d12_x/interfaces/ID3D12CommandAllocator/id3d12commandallocator)).
O **REFIID**, ou **GUID**, da interface do alocador de comandos pode ser obtido usando a macro \_\_uuidof().
Por exemplo, \_\_uuidof(ID3D12CommandAllocator) obterá o **GUID** da interface de um alocador de comandos.

*ppCommandAllocator \[out]*\
Tipo: void \*\*

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface [ID3D12CommandAllocator](/pt-BR/reference/graphics/d3d12_x/interfaces/ID3D12CommandAllocator/id3d12commandallocator) do alocador de comandos.

### Valor retornado

Tipo: HRESULT

Este método retornará **E\_OUTOFMEMORY** se não houver memória suficiente para criar o alocador de comandos.
Consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) para outros valores retornados possíveis.

## Comentários

O dispositivo cria listas de comandos a partir do alocador de comandos.

#### Exemplos

O exemplo [D3D12Bundles](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/working-samples) usa **ID3D12Device::CreateCommandAllocator** da seguinte maneira:

```cpp theme={null}
ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));
ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_BUNDLE, IID_PPV_ARGS(&m_bundleAllocator)));

```

Consulte o [Código de exemplo na referência do D3D12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/notes-on-example-code).

<div class="code" />

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas compatíveis**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12Device](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [CreateCommandList](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandlist_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)
- [CreateCommandQueue](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandqueue_public.md)
- [CreateCommandSignature](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandsignature_public.md)