EQUALIZERSETTINGS Element
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The EQUALIZERSETTINGS element provides a way to manipulate the graphic equalizer and other audio settings of Windows Media Player using the attributes and method listed here.
The EQUALIZERSETTINGS element supports the following attributes.
| Attribute | Description |
|---|---|
| bands | Retrieves the number of frequency bands supported. |
| bypass | Specifies or retrieves a value indicating whether the equalizer filter is bypassed in the filter graph. |
| crossFade | Specifies or retrieves a value indicating whether cross-fade is enabled. |
| crossFadeWindow | Specifies or retrieves the amount of cross-fade overlap in milliseconds. |
| currentPreset | Specifies or retrieves the index of the current preset. |
| currentPresetTitle | Retrieves the title of the current preset. |
| currentSpeakerName | Retrieves the name of the current speaker setting. |
| enableSplineTension | Specifies or retrieves a value indicating whether spline tension is enabled or disabled. |
| enhancedAudio | Specifies or retrieves a value indicating whether enhanced audio is turned on. |
| gainLevels | Specifies or retrieves the gain level of the band corresponding to the index provided. |
| gainLevel1 | Specifies or retrieves the gain level of band 1. |
| gainLevel2 | Specifies or retrieves the gain level of band 2. |
| gainLevel3 | Specifies or retrieves the gain level of band 3. |
| gainLevel4 | Specifies or retrieves the gain level of band 4. |
| gainLevel5 | Specifies or retrieves the gain level of band 5. |
| gainLevel6 | Specifies or retrieves the gain level of band 6. |
| gainLevel7 | Specifies or retrieves the gain level of band 7. |
| gainLevel8 | Specifies or retrieves the gain level of band 8. |
| gainLevel9 | Specifies or retrieves the gain level of band 9. |
| gainLevel10 | Specifies or retrieves the gain level of band 10. |
| normalization | Specifies or retrieves a value indicating whether normalization is enabled. |
| normalizationAverage | Retrieves the average normalization value. |
| normalizationPeak | Retrieves the peak normalization value. |
| presetCount | Retrieves the number of presets available. |
| speakerSize | Specifies or retrieves the index of the current speaker size. |
| splineTension | Specifies or retrieves the spline tension for the equalizer control. |
| truBassLevel | Specifies or retrieves the SRS TruBass level. |
| wowLevel | Specifies or retrieves the SRS WOW Effect level. |
The EQUALIZERSETTINGS element supports the following methods.
| Method | Description |
|---|---|
| nextPreset | Applies the next equalizer preset. |
| presetTitle | Retrieves the name of the equalizer preset with the specified index. |
| previousPreset | Applies the previous equalizer preset. |
| reset | Resets the gain levels of all bands to zero decibels. |
The EQUALIZERSETTINGS element can implement the attribute_onchange event handlers.
Related topics