# NNS_SndArcLoadGroup

## Syntax

      #include <nnsys/snd.h>

      BOOL NNS_SndArcLoadGroup( int groupNo, NNSSndHeapHandle heap );

## Arguments

`groupNo` | Group number.
`heap` | Sound heap handle.

## Return Values

Returns a value that indicates whether or not the load was successful.

## Description

Loads sound data to the heap in group units.

A group is a compilation of multiple sound data. By loading with group units, multiple sound data can be loaded at once. The composition of the sound data is defined in the sound archive.

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

The sound data already resident in memory is not loaded. Execution of the `NNS_SndArcGetFileAddress` function will determine if the sound data is resident in memory. In addition, the `NNS_SndArcSetFileAddress` function sets the address of the successfully loaded data.

If you wish to limit the size of data that can be loaded at one time, use the `NNS_SndArcSetLoadBlockSize` function to specify the load block size.

### Note

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

## See Also

`NNS_SndHeapAlloc`, `NNS_SndArcGetFileAddress`, `NNS_SndArcSetFileAddress`, `NNS_SndArcSetLoadBlockSize`, `NNS_SndArcInit`, `NNS_SndArcInitOnMemory`

## Revision History

2007/10/17 Added descriptions related to the `NNS_SndArcSetLoadBlockSize` function.
2004/06/01 Initial version.

CONFIDENTIAL