#include <nnsys/snd.h>BOOL NNS_SndArcLoadWaveArc( int waveArcNo, NNSSndHeapHandle heap );
Loads the waveform archive to the heap.
With the NNS_SndHeapAlloc function, the memory necessary for loading is automatically allocated from the sound heap, heap. 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