Classes > SoundComposerMan class > Methods > SoundComposer.ItemAmplitudeGet method

Remarks

Obtains the amplitude used to generate a specific item. The amplitude can be modified through the SoundComposer.ItemAmplitudeSet method.

This method cannot be used to obtain the amplitude of a sliding wave tone: for this purpose you can use the SoundComposer.ItemSlidingWaveToneLimitsGet method.

For further details about sound composing see the the SoundComposerMan class and the How to compose a sound tutorial.

Syntax

[Visual Basic]

Public Function ItemAmplitudeGet (

nUniqueId as Int32,

ByRef fAmplitude as Single

[C#]

public enumErrorCodes ItemAmplitudeGet (

Int32 nUniqueId,

ref float fAmplitude

);

[C++]

public: enumErrorCodes ItemAmplitudeGet (

Int32 nUniqueId,

float __gc *fAmplitude

);

Parameter	Description

nUniqueId	The unique identifier of the element previously returned by the call to one of the following methods: - SoundComposer.ItemDtmfStringAdd for DTMF items. - SoundComposer.ItemNoiseAdd for noise tone items. - SoundComposer.ItemSlidingWaveToneAdd for sliding wave tone items. - SoundComposer.ItemSoundFileAdd, SoundComposer.ItemSoundFileMemoryAdd, SoundComposer.ItemSoundFileRawAdd, SoundComposer.ItemSoundFileMemoryRawAdd, SoundComposer.ItemSoundFileFromEditorAdd,and SoundComposer.ItemSoundFileFromRecorderAdd for sound file items - SoundComposer.ItemWaveToneAdd for wave tone items. - SoundComposer.ItemSpeechFromStringAdd and SoundComposer.ItemSpeechFromFileAdd for text to speech items.
fAmplitude	Reference that, on return from the method call, will contain the item's amplitude. - value 0.0 means that sound volume is muted - values higher than 0.0 and lower than 1.0 attenuate the sound volume - value 1.0 sets the sound at full volume - values higher than 1.0 amplify the sound volume

Return value

Value	Meaning

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