Remarks
Specifies if the VU-Meter must keep count of the volume set into the DirectSound buffer of the given player, through a previous call to the StreamVolumeDirectSoundBufferSet method, in order to calculate the volume level. This method has no effect without a previous call to the VUMeter.Create method.
For further details about using the embedded VU-Meter refer to the VUMeter object section.
For details about using Visual Feedbacks refer to the How to use the embedded Visual Feedbacks section.
Syntax
[C++]
short control.VUMeter.KeepCountOfVolume (
short nPlayer,
short bKeepCountOfVolume
);
|
|
Parameter
|
Description
|
|
|
nPlayer
|
Number representing the zero-based index of the player that will use the VU-Meter
|
bKeepCountOfVolume
|
Boolean flag that specifies if the VU-Meter must keep count of volume.
Supported values are the following:
Mnemonic constant
|
Value
|
Meaning
|
BOOL_FALSE
|
0
|
Doesn't keep count of volume set through the StreamVolumeDirectSoundBufferSet method: in this case the VU-Meter will always display the original volume level of the sound being played.
|
BOOL_TRUE (default)
|
1
|
Keeps count of volume: in this case any change to the player's volume performed through the StreamVolumeDirectSoundBufferSet method will be reflected into the visualization of the VU-meter and into values reported by the VUMeterValueChange event.
|
|
Return value
Value
|
Meaning
|
|
|
Negative value
|
An error occurred, check the LastError property value in order to get the error code
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful
|
|
