RequestSoundSilenceDetection method

RequestSoundSilenceDetection method

Remarks

Requests the calculation of silent portions at the start and end of the sound loaded inside the given player: useful when the automatic silence detection has been disabled through a call to the SetAutomaticSilenceDetection method.

This method doesn't work with sounds with more than 2 channels (5.1 or 7.1) or if the EnableMixingFeatures property has been set to BOOL_FALSE.

Once detected, the container application will be notified about initial and final positions of silent portions at the start and end of loaded songs through the SilencePositionAvailable event.

Syntax

[Visual Basic]

control.RequestSoundSilenceDetection (

nPlayer as Integer,

nThresholdInitial as Long,

nThresholdFinal as Long

) as enumErrorCodes

[C++]

short control.RequestSoundSilenceDetection (

short nPlayer,

Int32 nThresholdInitial,

Int32 nThresholdFinal

);

Parameter	Description

nPlayerIndex	Number representing the zero-based index of the involved player
nThresholdInitial	Number representing the silence threshold at the start of the loaded sound: can assume values from 0 (no sound) to 32767 (max volume).
nThresholdFinal	Number representing the silence threshold at the end of the loaded sound: can assume values from 0 (no sound) to 32767 (max volume).

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

Return to Table of contents