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

Crée le tas APU.

## Syntaxe

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

### Paramètres

*cachedSizeInBytes*   \_In\_\
Type : UINT32

Taille d'une allocation de mémoire mise en cache, en octets.

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

Taille d'une allocation non mise en cache, en octets. Si la valeur est 0, l'allocation par défaut d'environ 1 Mo est utilisée.

### Valeur de retour

Type : HRESULT

En plus d'autres codes d'erreur, cette méthode peut renvoyer les valeurs suivantes :

| Code de retour | Description |
| :- | :- |
| S\_OK | Réussite |
| E\_INVALIDARG | Argument non valide (taille == 0) |
| E\_OUTOFMEMORY | Échec de l'allocation de mémoire |
| APU\_E\_HEAP\_ALREADY\_ALLOCATED | Le tas a déjà été alloué |

## Remarques

Un seul tas APU peut être créé; il persiste pendant toute la durée de vie du processus. Le tas n'est libéré qu'à la fin du processus.

Pour vous assurer qu'un tas est alloué selon vos exigences précises, appelez cette méthode avant toute autre méthode ACP HAL et APU.

Si des méthodes [ACP HAL](/fr-CA/reference/audio/acphal/acphal_members) (AcpHal.h) ou [APU](/fr-CA/reference/audio/apu/apu_members) sont appelées avant cette méthode, un tas mis en cache de 64 Mo et un tas non mis en cache d'environ 1 Mo sont alloués; les appels ultérieurs à cette méthode échoueront avec `APU_E_HEAP_ALREADY_ALLOCATED`.

La mémoire mise en cache est utilisée pour toutes les ressources Waves ainsi que pour les files d'attente de commandes et de messages. La mémoire non mise en cache est utilisée pour les contextes SHAPE et les notifications.

## 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 d'ACP](/fr-CA/build/console-features/audio/overviews/acp-overview)

## Voir aussi

[APU](/fr-CA/reference/audio/apu/apu_members)


## Related topics

- [ApuCreateHeap](/reference/audio/apu/functions/apucreateheap.md)
- [ApuHeapState](/reference/audio/apu/structs/apuheapstate.md)
- [ApuHeapGetState](/reference/audio/apu/functions/apuheapgetstate.md)
- [APU (Audio Processing Unit)](/reference/audio/apu/apu_members.md)
- [APU(音频处理单元)](/zh-CN/reference/audio/apu/apu_members.md)