#include <nnsys/snd.h>BOOL NNS_SndArcLoadGroup( int groupNo, NNSSndHeapHandle heap );
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.
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.
NNS_SndHeapAlloc, NNS_SndArcGetFileAddress, NNS_SndArcSetFileAddress, NNS_SndArcSetLoadBlockSize, NNS_SndArcInit, NNS_SndArcInitOnMemory
2007/10/17 Added descriptions related to the NNS_SndArcSetLoadBlockSize function.
2004/06/01 Initial version.
CONFIDENTIAL