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

# ApuCreateHeap

> ApuCreateHeap

# ApuCreateHeap

Crea el montón de la APU.

## Sintaxis

```cpp theme={null}
HRESULT ApuCreateHeap(  
         UINT32 cachedSizeInBytes,  
         UINT32 nonCachedSizeInBytes = 0  
)  
```

### Parámetros

*cachedSizeInBytes*   \_In\_\
Tipo: UINT32

Tamaño de una asignación de memoria almacenada en caché, en bytes.

*nonCachedSizeInBytes*   \_In\_opt\_\
Tipo: UINT32

Tamaño de una asignación no almacenada en caché, en bytes. Si es 0, se usa la asignación predeterminada de \~1 MB.

### Valor devuelto

Tipo: HRESULT

Además de otros códigos de error, este método puede devolver los valores siguientes:

| Código devuelto                  | Descripción                       |
| :------------------------------- | :-------------------------------- |
| S\_OK                            | Correcto                          |
| E\_INVALIDARG                    | Argumento no válido (tamaño == 0) |
| E\_OUTOFMEMORY                   | Error de asignación de memoria    |
| APU\_E\_HEAP\_ALREADY\_ALLOCATED | El montón ya se ha asignado       |

## Comentarios

Solo se puede crear un único montón de la APU; persiste durante la vigencia del proceso. El montón se libera solo cuando el proceso termina.

Para asegurarse de que el montón se asigna según sus requisitos específicos, llame a este método antes que a cualquier otro método de ACP HAL y APU.

Si se llama a algún método de [ACP HAL](/reference/audio/acphal/acphal_members) (AcpHal.h) o de [APU](/reference/audio/apu/apu_members) antes que a este método, se asignan un montón en caché de 64 MB y un montón no almacenado en caché de \~1 MB; las llamadas posteriores a este método producirán un error con `APU_E_HEAP_ALREADY_ALLOCATED`.

La memoria almacenada en caché se usa para todos los recursos de Waves y las colas de comandos y mensajes. La memoria no almacenada en caché se usa para los contextos y las notificaciones de SHAPE.

## Requisitos

**Encabezado:** apu.h

**Biblioteca:** acphal.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Información general sobre ACP](/build/console-features/audio/overviews/acp-overview)

## Consulte también

[APU](/reference/audio/apu/apu_members)


## Related topics

- [ApuHeapState](/es/reference/audio/apu/structs/apuheapstate.md)
- [ApuHeapGetState](/es/reference/audio/apu/functions/apuheapgetstate.md)
- [APU (Audio Processing Unit)](/es/reference/audio/apu/apu_members.md)
- [Información general sobre ACP](/es/build/console-features/audio/overviews/acp-overview.md)
- [IAcpHal::SubmitCommand](/es/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)