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

Alloue de la mémoire physique APU.

## Syntaxe

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

### Paramètres

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

Adresse virtuelle renvoyée.

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

`APU_ADDRESS` renvoyée; à utiliser avec l'APU.

*sizeInBytes*   \_In\_\
Type : UINT32

Taille de l'allocation, en octets.

*alignmentInBytes*   \_In\_\
Type : UINT32

Alignement, en octets. Doit être une puissance de 2 supérieure ou égale à 4.

*flags*\
Type : UINT32

Indicateur d'allocation : `APU_ALLOC_CACHED` ou `APU_ALLOC_NONCACHED`.

### Valeur de retour

Type : HRESULT

Cette méthode peut renvoyer les valeurs suivantes :

| Code de retour | Description |
| :- | :- |
| S\_OK | Réussite |
| E\_INVALIDARG | Argument non valide, par exemple adresse virtuelle == nullptr, taille == 0, alignement == 0, (alignment & 0x3) != 0, (alignment & (alignment - 1)) != 0, ou valeur d'indicateurs non valide |
| E\_OUTOFMEMORY | Échec de l'allocation de mémoire |

## Remarques

Les adresses virtuelle et physique renvoyées représentent des vues différentes du même espace d'adressage. La libération de l'une invalide l'autre. Pour libérer une allocation, utilisez [ApuFree](/fr-CA/reference/audio/apu/functions/apufree).

## Configuration requise

**En-tête :** apu.h

**Bibliothèque :** acphal.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Vue d'ensemble de XMA2](/fr-CA/build/console-features/audio/overviews/xma2-overview)

## Voir aussi

[ApuFree](/fr-CA/reference/audio/apu/functions/apufree)\
[APU](/fr-CA/reference/audio/apu/apu_members)


## Related topics

- [ApuAlloc](/reference/audio/apu/functions/apualloc.md)
- [ApuMapApuAddress](/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuFree](/reference/audio/apu/functions/apufree.md)
- [ApuMapVirtualAddress](/reference/audio/apu/functions/apumapvirtualaddress.md)
- [ApuIsVirtualAddressValid](/reference/audio/apu/functions/apuisvirtualaddressvalid.md)