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

> Crea un objeto asignador de comandos.

Crea un objeto asignador de comandos.

## Sintaxis

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

### Parámetros

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

Un valor de tipo [D3D12\_COMMAND\_LIST\_TYPE](/reference/graphics/d3d12_x/enums/d3d12_command_list_type) que especifica el tipo de asignador de comandos que se va a crear.
El tipo de asignador de comandos puede ser el tipo que graba listas de comandos directas o agrupaciones.

*riid*\
Tipo: const IID &

El identificador único global (**GUID**) de la interfaz del asignador de comandos ([ID3D12CommandAllocator](/reference/graphics/d3d12_x/interfaces/ID3D12CommandAllocator/id3d12commandallocator)).
El **REFIID**, o **GUID**, de la interfaz del asignador de comandos se puede obtener mediante la macro \_\_uuidof().
Por ejemplo, \_\_uuidof(ID3D12CommandAllocator) obtendrá el **GUID** de la interfaz de un asignador de comandos.

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

Un puntero a un bloque de memoria que recibe un puntero a la interfaz [ID3D12CommandAllocator](/reference/graphics/d3d12_x/interfaces/ID3D12CommandAllocator/id3d12commandallocator) del asignador de comandos.

### Valor devuelto

Tipo: HRESULT

Este método devuelve **E\_OUTOFMEMORY** si no hay memoria suficiente para crear el asignador de comandos.
Consulte [códigos de retorno de Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) para conocer otros valores devueltos posibles.

## Comentarios

El dispositivo crea listas de comandos a partir del asignador de comandos.

#### Ejemplos

El ejemplo [D3D12Bundles](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/working-samples) usa **ID3D12Device::CreateCommandAllocator** de la siguiente manera:

```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 el [código de ejemplo en la referencia de D3D12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/notes-on-example-code).

<div class="code" />

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)