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

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\*](/reference/audio/apu/structs/apuheapstate)

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](/reference/audio/apu/structs/apuheapstate).

Para crear un montón de la APU, llame a [ApuCreateHeap](/reference/audio/apu/functions/apucreateheap). 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](/reference/audio/apu/structs/apuheapstate)\
[APU](/reference/audio/apu/apu_members)


## Related topics

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