spContinueAtMarker

Clear static branch at a marker.

Synopsis

Err spContinueAtMarker (SPSound *sound, const char *markerName)

Description

Restores the marker to its default action of playing through (for a marker in the middle of a sound), or stopping (for a marker at the end of a sound), barring the results from a marker or default decision function. This resets the effect of spBranchAtMarker() or spStopAtMarker().

Markers can have one of 3 static actions: continue, branch, or stop. This action can be changed at any time, including while the player is playing.

Arguments

sound: Pointer to SPSound containing marker to clear branch from.

markerName: Name of marker in sound to clear branch from. All markers except markers at the beginning of sounds are considered valid for this function.

Return Value

Non-negative value on success; negative error code on failure.

Implementation

Library call implemented in music.lib V24.

Associated Files

soundplayer.h, music.lib