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