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

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

## Syntax

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

### Parameters

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

힙의 현재 상태입니다.

*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](/reference/audio/apu/structs/apuheapstate) 구조체를 반환합니다.

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

## Requirements

**Header:** apu.h

**Library:** acphal.lib

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

## See also

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


## Related topics

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