# NNS_SndArcLoadWaveArc

## Syntax

      #include <nnsys/snd.h>

      BOOL NNS_SndArcLoadWaveArc( int waveArcNo, NNSSndHeapHandle heap );

## Arguments

`waveArcNo` | Waveform archive number.
`heap` | Sound heap handle.

## Return Values

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

## Description

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.

### 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