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

# ApuHeapGetState

> ApuHeapGetState

# ApuHeapGetState

Interroge l'état actuel du tas physique APU.

## Syntaxe

```cpp theme={null}
HRESULT ApuHeapGetState(  
         ApuHeapState* apuHeapState,  
         UINT32 flags = APU_ALLOC_CACHED  
)  
```

### Paramètres

*apuHeapState*   \_Out\_\
Type : [ApuHeapState\*](/fr-CA/reference/audio/apu/structs/apuheapstate)

État actuel du tas.

*flags*   \
Type : UINT32

Tas à interroger : `APU_ALLOC_CACHED` pour le tas mis en cache, ou `APU_ALLOC_NONCACHED` pour le tas non mis en cache.

### Valeur de retour

Type : HRESULT

| Code de retour | Description |
| :- | :- |
| S\_OK | Réussite |
| APU\_E\_HEAP\_NOT\_ALLOCATED | Le tas APU n'a pas été alloué |
| E\_INVALIDARG | Argument non valide |

## Remarques

Cette fonction renvoie une structure [ApuHeapState](/fr-CA/reference/audio/apu/structs/apuheapstate).

Pour créer un tas APU, appelez [ApuCreateHeap](/fr-CA/reference/audio/apu/functions/apucreateheap). Un tas APU persiste pendant toute la durée de vie du processus.

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

## Voir aussi

[ApuHeapState](/fr-CA/reference/audio/apu/structs/apuheapstate)\
[APU](/fr-CA/reference/audio/apu/apu_members)


## Related topics

- [ApuHeapGetState](/es/reference/audio/apu/functions/apuheapgetstate.md)
- [ApuHeapState](/reference/audio/apu/structs/apuheapstate.md)
- [APU (Audio Processing Unit)](/reference/audio/apu/apu_members.md)
- [APU(音频处理单元)](/zh-CN/reference/audio/apu/apu_members.md)
- [APU (오디오 처리 장치)](/ko/reference/audio/apu/apu_members.md)