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

# ApuAlloc

> ApuAlloc

# ApuAlloc

Aloca memória física da APU.

## Sintaxe

```cpp theme={null}
HRESULT ApuAlloc(  
         void** virtualAddress,  
         APU_ADDRESS* physicalAddress,  
         UINT32 sizeInBytes,  
         UINT32 alignmentInBytes = 4,  
         UINT32 flags = APU_ALLOC_CACHED  
)  
```

### Parâmetros

*virtualAddress*   \_Result\_nullonfailure\_ \_Outptr\_result\_bytebuffer\_(sizeInBytes)\
Tipo: void\*\*

Endereço virtual retornado.

*physicalAddress*   \_Result\_zeroonfailure\_ \_Out\_opt\_\
Tipo: APU\_ADDRESS\*

`APU_ADDRESS` retornado; para uso com a APU.

*sizeInBytes*   \_In\_\
Tipo: UINT32

Tamanho da alocação, em bytes.

*alignmentInBytes*   \_In\_\
Tipo: UINT32

Alinhamento, em bytes. Deve ser uma potência de 2 e maior ou igual a 4.

*flags*\
Tipo: UINT32

Sinalizador de alocação: `APU_ALLOC_CACHED` ou `APU_ALLOC_NONCACHED`.

### Valor de retorno

Tipo: HRESULT

Este método pode retornar os seguintes valores:

| Código de retorno | Descrição |
| :- | :- |
| S\_OK | Êxito |
| E\_INVALIDARG | Argumento inválido, como virtual address == nullptr, size == 0, alignment == 0, (alignment & 0x3) != 0, (alignment & (alignment - 1)) != 0 ou um valor de flags inválido |
| E\_OUTOFMEMORY | Falha na alocação de memória |

## Comentários

Os endereços virtual e físico retornados representam exibições diferentes do mesmo espaço de endereço. Liberar um invalida o outro. Para liberar uma alocação, use [ApuFree](/pt-BR/reference/audio/apu/functions/apufree).

## 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 XMA2](/pt-BR/build/console-features/audio/overviews/xma2-overview)

## Confira também

[ApuFree](/pt-BR/reference/audio/apu/functions/apufree)\
[APU](/pt-BR/reference/audio/apu/apu_members)


## Related topics

- [ApuFree](/pt-BR/reference/audio/apu/functions/apufree.md)
- [ApuMapApuAddress](/pt-BR/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuMapVirtualAddress](/pt-BR/reference/audio/apu/functions/apumapvirtualaddress.md)
- [ApuIsVirtualAddressValid](/pt-BR/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [Visão geral do XMA2](/pt-BR/build/console-features/audio/overviews/xma2-overview.md)