C4 Engine
C4 Engine API Documentation

Sound::PauseSound

Defined in:  C4Sound.h
Pauses a sound.
Prototype

void PauseSound(void);

Description
The PauseSound function pauses a sound at its current position. The sound can be resumed by calling the Sound::ResumeSound function. If the sound is not playing, then the Pause function has no effect.

If the PauseSound function is called multiple times for the same sound, then each call must be balanced by a call to the Sound::ResumeSound function before the sound will continue playing (i.e., the sound keeps track of an internal pause count).

If the PauseSound function is called for a sound that is scheduled to play because the Sound::DelaySound function was previously called, then the time between the first PauseSound call and the balancing Sound::ResumeSound call is not counted against the delay time. That is, the delay is paused as if the sound was playing silence until it was scheduled to begin playing.
See Also

Sound::ResumeSound

Sound::StopSound