> ## 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 物理ヒープの現在の状態を照会します。

## 構文

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

### パラメーター

*apuHeapState*   \_Out\_\
型: [ApuHeapState\*](https://docs.xbox.com/ja-jp/reference/audio/apu/structs/apuheapstate.md)

ヒープの現在の状態。

*flags*   \
型: UINT32

照会するヒープ: キャッシュ ヒープの場合は `APU_ALLOC_CACHED`、非キャッシュ ヒープの場合は `APU_ALLOC_NONCACHED`。

### 戻り値

型: HRESULT

| 戻り値コード | 説明 |
| :- | :- |
| S\_OK | 成功 |
| APU\_E\_HEAP\_NOT\_ALLOCATED | APU ヒープが割り当てられていません |
| E\_INVALIDARG | 無効な引数 |

## 解説

この関数は [ApuHeapState](https://docs.xbox.com/ja-jp/reference/audio/apu/structs/apuheapstate.md) 構造体を返します。

APU ヒープを作成するには、[ApuCreateHeap](https://docs.xbox.com/ja-jp/reference/audio/apu/functions/apucreateheap.md) を呼び出します。APU ヒープはプロセスの有効期間中保持されます。

## 要件

**ヘッダー:** apu.h

**ライブラリ:** acphal.lib

**サポート対象プラットフォーム:** XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

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


## Related topics

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