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

APU 물리적 힙의 현재 상태를 쿼리합니다.

## Syntax

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

### Parameters

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

힙의 현재 상태입니다.

*flags*   \
Type: UINT32

쿼리할 힙: 캐시된 힙은 `APU_ALLOC_CACHED`, 캐시되지 않은 힙은 `APU_ALLOC_NONCACHED`.

### Return value

Type: HRESULT

| 반환 코드 | 설명 |
| :- | :- |
| S\_OK | 성공 |
| APU\_E\_HEAP\_NOT\_ALLOCATED | APU 힙이 할당되지 않음 |
| E\_INVALIDARG | 유효하지 않은 인수 |

## Remarks

이 함수는 [ApuHeapState](https://docs.xbox.com/ko/reference/audio/apu/structs/apuheapstate.md) 구조체를 반환합니다.

APU 힙을 생성하려면 [ApuCreateHeap](https://docs.xbox.com/ko/reference/audio/apu/functions/apucreateheap.md)을 호출하세요. APU 힙은 프로세스의 수명 동안 유지됩니다.

## Requirements

**Header:** apu.h

**Library:** acphal.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## See also

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


## Related topics

- [ApuHeapState](https://docs.xbox.com/ko/reference/audio/apu/structs/apuheapstate.md)
- [APU(오디오 처리 장치)](https://docs.xbox.com/ko/reference/audio/apu/apu_members.md)
- [ApuCreateHeap](https://docs.xbox.com/ko/reference/audio/apu/functions/apucreateheap.md)
- [XApuStateOptions](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapustateoptions.md)
- [XApuProcessType](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuprocesstype.md)