NNS_SndArcSetup

C Specification

#include <nnsys/snd.h>
BOOL NNS_SndArcSetup(
        NNSSndArc* arc,
        NNSSndHeapHandle heap,
        BOOL symbolLoadFlag );

Arguments

arc Pointer to the sound archive structure.
heap The sound heap handle
symbolLoadFlag Flag that determines whether to load symbol data.

Return Values

Returns a boolean value to indicate if the setup is successful.

Description

This function sets up the sound archive.

This function is called from the NNS_SndArcInit function. Normally, there is no need for you to call it.

Internally, this function loads data required to manage the sound archive. It allocates memory for holding management data from the sound heap specified by heap. The function will fail if it cannot allocate sufficient memory.

If you set the symbol load flag symbolLoadFlag to TRUE, this function can use the NNS_SndArcGet*Symbol function to acquire symbol names. However, this requires more of the sound heap.

See Also

NNS_SndArcInit,
NNS_SndArcGet*Symbol

Revision History

2004/09/02 Initial version.


CONFIDENTIAL