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

Cria o heap da APU.

## Sintaxe

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

### Parâmetros

*cachedSizeInBytes*   \_In\_\
Tipo: UINT32

Tamanho de uma alocação de memória em cache, em bytes.

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

Tamanho de uma alocação sem cache, em bytes. Se for 0, será usada a alocação padrão de \~1 MB.

### Valor de retorno

Tipo: HRESULT

Além de outros códigos de erro, este método pode retornar os seguintes valores:

| Código de retorno | Descrição |
| :- | :- |
| S\_OK | Êxito |
| E\_INVALIDARG | Argumento inválido (size == 0) |
| E\_OUTOFMEMORY | Falha na alocação de memória |
| APU\_E\_HEAP\_ALREADY\_ALLOCATED | O heap já foi alocado |

## Comentários

Somente um único heap da APU pode ser criado; ele persiste durante todo o tempo de vida do processo. O heap é liberado somente quando o processo é encerrado.

Para garantir que um heap seja alocado de acordo com seus requisitos específicos, chame este método antes de qualquer outro método do ACP HAL e da APU.

Se qualquer método do [ACP HAL](/pt-BR/reference/audio/acphal/acphal_members) (AcpHal.h) ou da [APU](/pt-BR/reference/audio/apu/apu_members) for chamado antes deste método, serão alocados um heap em cache de 64 MB e um heap sem cache de \~1 MB; as chamadas subsequentes a este método falharão com `APU_E_HEAP_ALREADY_ALLOCATED`.

A memória em cache é usada para todos os ativos do Waves e para as filas de comandos e mensagens. A memória sem cache é usada para contextos SHAPE e notificações.

## Requisitos

**Cabeçalho:** apu.h

**Biblioteca:** acphal.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)

## Confira também

[APU](/pt-BR/reference/audio/apu/apu_members)


## Related topics

- [ApuHeapState](/pt-BR/reference/audio/apu/structs/apuheapstate.md)
- [ApuHeapGetState](/pt-BR/reference/audio/apu/functions/apuheapgetstate.md)
- [APU (Unidade de Processamento de Áudio)](/pt-BR/reference/audio/apu/apu_members.md)
- [Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview.md)
- [IAcpHal::SubmitCommand](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)