NNS_SndArcLoadSeq*

Syntax

#include <nnsys/snd.h>

#define NNS_SND_ARC_LOAD_SEQ  ( 1 << 0 )
#define NNS_SND_ARC_LOAD_BANK ( 1 << 1 )
#define NNS_SND_ARC_LOAD_WAVE ( 1 << 2 )

BOOL NNS_SndArcLoadSeq( int seqNo, NNSSndHeapHandle heap );
BOOL NNS_SndArcLoadSeqEx(
        int seqNo,
        u32 loadFlag,
        NNSSndHeapHandle heap );

Arguments

`seqNo`	Sequence number.
`heap`	Sound heap handle.
`loadFlag`	Flag that designates the data to be loaded.

Return Values

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

Description

Loads the sequence data to the heap.

The NNS_SndArcLoadSeq function loads the bank data and the waveform archive needed for playback of sequence data at the same time. With loadFlag, the NNS_SndArcLoadSeqEx function designates which of the three types of data to load. loadFlag holds the logical OR of the following macros:

Table: Load Flags

Macros	Value	Description
`NNS_SND_ARC_LOAD_SEQ`	1 << 0	Sequence data.
`NNS_SND_ARC_LOAD_BANK`	1 << 1	Bank data.
`NNS_SND_ARC_LOAD_WAVE`	1 << 2	Waveform 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.

Revision History

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