# NNS_SndArcStrmInit

## Syntax

      #include <nnsys/snd.h>

      void NNS_SndArcStrmInit( u32 threadPrio, NNSSndHeapHandle heap );

## Arguments

`threadPrio` | Stream thread priority
`heap` | Sound heap handle.

## Return Values

None.

## Description

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

This function internally starts the stream thread and sets up the stream player. To set up the stream player, a buffer for the stream is secured from the sound heap specified by `heap`.

When the sound heap region that allocated 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 NITRO Game Cards. The stream playback may be interrupted if its priority is low.

The stream buffer requires a size, per each stream player, of 2048 (bytes) x the number of channels. The sound archive defines which channels are used by which numbered stream player.

## See Also

NNS_SndArcInit, NNS_SndArcInitOnMemory, NNS_SndArcStrmSetupPlayer

## Revision History

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

CONFIDENTIAL