Methods > Players and stream mixers > PlaySoundRange method

Remarks

Plays a specific range of sound that has been previously loaded through one of the many methods having the "Load" prefix like LoadSound or LoadSoundFromMemory,

By default playback continues till the end of the defined range until the final position is not moved through the PlaySoundMoveFinalPos method.

A successful call to this method will fire the SoundPlaying event. Once the sound portion has been performed completely, the control will fire the SoundDone event.

A portion of sound can be played a given number of times through the PlaySoundRangeLoop method.

Syntax

[Visual Basic]

control.PlaySoundRange (

nPlayer as Integer,

nFromPosition as Long,

nToPosition as Long

) as enumErrorCodes

[C++]

short control.PlaySoundRange (

short nPlayer,

long nFromPosition,

long nToPosition

);

Parameter	Description

nPlayer	Number representing the zero-based index of the player that will play the sound range
nFromPosition	Range starting point in the unit specified by the ScaleUnits property.
nToPosition	Range ending point in the unit specified by the ScaleUnits property. Set this value to -1 for playing till the song end

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The method call was successful