# NNS_SndHeapGetCurrentLevel

## Syntax

      #include <nnsys/snd.h>

      int NNS_SndHeapGetCurrentLevel( NNSSndHeapHandle heap );

## Arguments

`heap` | The sound heap handle.

## Return Values

Returns the current hierarchy level.

## Description

Gets the current hierarchical level (position within the hierarchy) of the sound heap.

The hierarchical level immediately after heap creation is `0`. The hierarchical level increases by 1 each time the `NNS_SndHeapSaveState` function is called. If the state is restored with the `NNS_SndHeapLoadState` function, the current hierarchical level will return to the assigned hierarchical level.

## See Also

`NNS_SndHeapSaveState, NNS_SndHeapLoadState`

## Revision History

2004/06/01 Initial version.

CONFIDENTIAL