Spools a sound file from disk to a sound buffer.
int32 ServiceSoundFile( SoundFilePlayer *sfp, int32 SignalIn, int32 *SignalNeeded )
This function is called repeatedly to spool the sound file from disk to a sound buffer played by StartSoundFile()
and controlled by the specified SoundFilePlayer data structure. It returns, in the SignalNeeded mask, the signal for the next sound buffer to finish playing. The task should use that signal in WaitSignal()
to enter wait state where it can wait for the buffer to finish playing. When it exits wait state, it passes the signal mask returned to ServiceSoundFile()
as the next buffer to write to.
This function returns 0 if successful or an error code (a negative value) if an error occurs.
Library call implemented in music.lib V20.
soundfile.h, music.lib
OpenSoundFile
(), CloseSoundFile(), DeleteSoundFilePlayer(), LoadSoundFile(), ReadSoundFile(), RewindSoundFile(), StartSoundFile(), StopSoundFile(), UnloadSoundFile(), CreateSoundFilePlayer()