NNS_SndArcStrmInit

C Specification

#include <nnsys/snd.h>
void NNS_SndArcStrmInit( u32 threadPrio, NNSSndHeapHandle heap );

Arguments

threadPrio Stream thread priority
heap The sound heap handle

Return Values

None.

Description

This function initializes the sound archive stream library. Call this function before calling any other NNS_SndArcStrm function.

The sound archive must be initialized in advance by NNS_SndArcInit or NNS_SndArcInitOnMemory.

The stream thread is started and the stream player is set up inside the function. To set up the stream player, the stream buffer is secured from the sound heap, which is specified with heap.

When the sound heap region that secures the stream buffer is released, the stream player stops automatically, and it becomes unusable. To make the stream player usable again, call the NNS_SndArcStrmSetupPlayer function.

The stream thread performs processes such as the loading of stream data from the NITRO Game Card. The stream playback may be interrupted if the priority is low.

The size of the stream buffer for each stream player requires 2048 x number of channels (bytes). The sound archive defines the channel that each stream player number uses.

See Also

NNS_SndArcInit, NNS_SndArcInitOnMemory, NNS_SndArcStrmSetupPlayer

Revision History

08/26/2005 Support for sound archive initialized by NNS_SndArcInitOnMemory function. 09/02/2004 Added explanation about NNS_SndArcStrmSetupPlayer function. 08/10/2004 Initial version.


CONFIDENTIAL