#include <nnsys/snd.h>BOOL NNS_SndArcStrmPrepareEx2(
NNSSndStrmHandle* handle,
int playerNo,
int playerPrio,
int strmNo,
u32 offset,
NNSSndStrmCallback strmCallback,
void* strmCallbackArg,
NNSSndArcStrmCallback sndArcStrmCallback,
void* sndArcStrmCallbackArg );handle |
Pointer to a stream handle |
playerNo |
The Player number |
playerPrio |
This is the player priority A greater value denotes a higher priority |
strmNo |
This is the stream number |
offset |
This is the starting offset position It is in msec |
strmCallback |
Pointer to a stream callback function |
strmCallbackArg |
User argument for the stream callback function |
sndArcStrmCallback |
This is the sound archive stream callback function pointer |
sndArcStrmCallbackArg |
This is the sound archive stream callback function user argument |
This function registers the callback functions and carries out stream preparations.
The sound archive stream library must be initialized in advance using the NNS_SndArcStrmInit function.
The stream handle handle needs to be initialized only once in advance using the NNS_SndStrmHandleInit function. Calling this function releases the stream already attached to the stream handle (this does not mean it is stopped). If playback succeeds, the stream is attached to the stream handle.
If -1 is specified for the player number playerNo and player priority playerPrio, the parameters specified with the sound data are used.
If a non-zero value is set for the start offset position offset, it is possible to play from the middle of the stream data.
The stream callback function strmCallback is periodically called during playback. Playback waveform data can be processed in this callback function. The user argument, strmCallbackArg, of the stream callback function is passed without any changes to the argument of the stream callback function strmCallback. If registration of the stream callback function is not required, NULL is entered. Refer to the description of NNSSndStrmCallback for information on the stream callback function.
The sound archive stream callback function sndArcStrmCallbackis called at a specified time. You can connect multiple stream data in real time and play them. The user argument sndArcStrmCallbackArg of the sound archive stream callback function is passed without any changes to the argument of the sound archive stream callback function sndArcStrmCallback. If registration of the sound archive stream callback function is not required, NULL is entered. Refer to the description of NNSSndArcStrmCallback for information on the sound archive stream callback function.
You can check whether the preparations are completed with the NNS_SndArcStrmIsPrepared function. Call the NNS_SndArcStrmStartPrepared function to play back the streams for which preparations are completed.
The channels used for stream playback are set aside in this function. If the channels set aside were being used by sequence playback, the sound being produced is automatically stopped. To control the timing of the channel set aside the NNS_SndArcStrmAllocChannel function needs to be called in advance.
If the stream data is in stereo, channel 0 is output from the left and channel 1 from the right. These settings can be changed with the NNS_SndArcStrmSetChannelPan function.
Playback failure may be the result of the following factors:
NNS_SndArcStrmInit, NNS_SndStrmHandleInit, NNSSndStrmCallback, NNSSndArcStrmCallback, NNS_SndArcStrmIsPrepared, NNS_SndArcStrmStartPrepared, NNS_SndArcStrmAllocChannel, NNS_SndArcStrmSetChannelPan
11/26/2004 Initial version.
CONFIDENTIAL