Remarks
Specifies if the VU-Meter must keep count of the volume set into the player 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 StreamVolumeSet 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 StreamVolumeSet method or through the StreamVolumeDirectSoundBufferSet method or during volume sliding 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
|
|
