Copyright © 2001-2008 MultiMedia Soft 
Return to Table of contents  
 
SetEqualizerBand method 
 
Remarks 
 
This control allows setting up a pool of 50 different equalizer bands for each player; each band works on a different frequency: this method creates one of these bands. 
 
The gain associated to a certain band can be modified using the SetEqualizerBandGain method. 
 
See the How to create and use an equalizer section for further details. 
 
 
Syntax 
 
[Visual Basic] 
control.SetEqualizerBand
nPlayer as Integer
nBandIndex as Integer
dwFrequency as Long, 
nBandwidthHz as Integer
bSet as enumBoolean 
 
[C++] 
short control.SetEqualizerBand
short nPlayer
short nBandIndex
DWORD dwFrequency
short nBandwidthHz
short bSet 
);
 
 
Parameter
Description
 
 
nPlayer
Number representing the zero-based index of the involved player
nBandIndex
Numeric value representing the zero-based index of the band to create inside the pool. Its value can be between 0 and 49
dwFrequency
Frequency expressed in hertz (Hz) in the range from 80 to 16000. 
A band's frequency cannot exceed one-third of the frequency of the playing channel so, if you have loaded a sound with a frequency of 44100 Hz, the maximum allowed band's frequency will be 14700 Hz (14700 * 3 = 44100); in order to reach a band's frequency of 16000 Hz, you must load sounds whose frequency is at least 48000 Hz.
nBandwidthHz
Bandwidth, expressed in semitones, in the range from 1 to 36
bSet
Boolean value that tells if this equalizer band must be enabled or disabled on the playing sound. 
 
Mnemonic constant
Value
Meaning
BOOL_FALSE
0
This equalizer band is disabled
BOOL_TRUE
1
This equalizer band is enabled
 
 
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
 
 
 
 
 
 
 
 
 
 
 
 
 
Copyright © 2001-2008 MultiMedia Soft 
Return to Table of contents