# NNS_SndArcLoadGroup

## C Specification

      #include <nnsys/snd.h>

      BOOL NNS_SndArcLoadGroup( int groupNo, NNSSndHeapHandle  heap );

## Arguments

`groupNo` | The group number
`heap` | The sound heap handle

## Return Values

Returns a value to indicate whether or not the load was successful.

## Description

Loads the sound data to the heap in group units.

This function is a compilation of the group with multiple sound data. By loading with group units, multiple sound data can be loaded at one time. The makeup of the sound data is defined in the sound archive.

The memory necessary for loading is automatically allocated from the sound heap heap with the `NNS_SndHeapAlloc` function. If memory allocation fails, the process is interrupted and a `FALSE` is returned.

Sound data that is already resident in memory is not loaded. Execution of the function `NNS_SndArcGetFileAddress` will determine whether or not the sound data is resident in memory. Also, the `NNS_SndArcSetFileAddress` function sets the address of the successfully loaded data.

### Note

Use this function only for the sound archive initialized with the `NNS_SndArcInit` function. This function cannot be used with the sound archive initialized with the `NNS_SndArcInitOnMemory` function.

## See Also

`NNS_SndHeapAlloc, NNS_SndArcGetFileAddress, NNS_SndArcSetFileAddress, NNS_SndArcInit, NNS_SndArcInitOnMemory`

## Revision History

06/01/2004 Initial version.