ssplStartSpooler

Start SoundSpooler.

Synopsis

Err ssplStartSpooler ( SoundSpooler *sspl, int32 Amplitude )

Description

ssplStartSpooler() starts the sound spooler's sample player instrument. It starts playback at the beginning of the first buffer in the active queue (submitted by ssplSendBuffer()). If there are no buffers in the active queue, playback will not begin until a buffer is submitted with a call to ssplSendBuffer().

If there is a SoundBufferFunc installed and there is a buffer in the active queue, sends a SSPL_SBMSG_INITIAL_START message with a pointer to the first active buffer. If SoundBufferFunc returns an error code, ssplStartSpooler() terminates and returns that error code.

This function sets SSPL_STATUS_F_STARTED and clears SSPL_STATUS_F_PAUSED.

Arguments

sspl
Pointer to a SoundSpooler structure.
Amplitude
A value of 0 to 0x7FFF that controls the loudness.

Return Value

Non-negative value on success, or negative 3DO error code on failure.

Implementation

Library call implemented in music.lib V21.

Associated Files

soundspooler.h, music.lib

See Also

ssplStartSpoolerTags(), ssplStopSpooler(), ssplPause(), ssplSendBuffer(), SoundBufferFunc(), StartInstrument(), ssplGetSpoolerStatus()