> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ApuHeapGetState

> ApuHeapGetState

# ApuHeapGetState

Consulta el estado actual del montón físico de la APU.

## Sintaxis

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

### Parámetros

*apuHeapState*   \_Out\_\
Tipo: [ApuHeapState\*](https://docs.xbox.com/es/reference/audio/apu/structs/apuheapstate.md)

Estado actual del montón.

*flags*   \
Tipo: UINT32

Montón que se va a consultar: `APU_ALLOC_CACHED` para el montón almacenado en caché, o `APU_ALLOC_NONCACHED` para el montón no almacenado en caché.

### Valor devuelto

Tipo: HRESULT

| Código devuelto | Descripción |
| :- | :- |
| S\_OK | Correcto |
| APU\_E\_HEAP\_NOT\_ALLOCATED | No se ha asignado el montón de la APU |
| E\_INVALIDARG | Argumento no válido |

## Comentarios

Esta función devuelve una estructura [ApuHeapState](https://docs.xbox.com/es/reference/audio/apu/structs/apuheapstate.md).

Para crear un montón de la APU, llame a [ApuCreateHeap](https://docs.xbox.com/es/reference/audio/apu/functions/apucreateheap.md). Un montón de la APU persiste durante la vigencia del proceso.

## Requisitos

**Encabezado:** apu.h

**Biblioteca:** acphal.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[ApuHeapState](https://docs.xbox.com/es/reference/audio/apu/structs/apuheapstate.md)\
[APU](https://docs.xbox.com/es/reference/audio/apu/apu_members.md)


## Related topics

- [ApuHeapState](https://docs.xbox.com/es/reference/audio/apu/structs/apuheapstate.md)
- [APU (Audio Processing Unit)](https://docs.xbox.com/es/reference/audio/apu/apu_members.md)
- [ApuCreateHeap](https://docs.xbox.com/es/reference/audio/apu/functions/apucreateheap.md)
- [XApuStateOptions](https://docs.xbox.com/es/reference/audio/xapu/enums/xapustateoptions.md)
- [XApuProcessType](https://docs.xbox.com/es/reference/audio/xapu/enums/xapuprocesstype.md)