NNS_SndArcInitOnMemory

C Specification

#include <nnsys/snd.h>
void NNS_SndArcInitOnMemory(  NNSSndArc*  arc, void*       data );

Arguments

arc The pointer to the NNSSndArc structure that manages the sound archive.
data The pointer to the sound archive data. Must have 32-byte alignment.

Return Values

None.

Description

Initializes the sound archive structure using the sound archive data in the memory. We recommend that you allocate the sound archive structure statically. If you choose to allocate dynamically, be aware of the following.

Use either this function or the NNS_SndArcInit to initialize the sound archive. If this function is used to initialize the sound archive, there is no need for memory management or loading of the sound data. Also, there is no need for the file system to be valid. However, if the file system is invalid it will require more memory.

The initialized sound archive is automatically set to the current sound archive. Use NNS_SndArcSetCurrent to modify the current sound archive.

Note

The sound archive structure can be discarded after releasing all sound heaps. Note that the pointer to the discarded sound archive structure may be set as the current sound archive.

See Also

NNS_SndArcInit, NNS_SndArcSetCurrent

Revision History

10/18/2005 Corrected the alignment value
09/06/2004 Added a precaution about dynamically allocating the NNS_SndArc structure.
06/01/2004 Initial version.


CONFIDENTIAL