EQUALIZERSETTINGS.gainLevels

[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 gainLevels attribute specifies or retrieves the gain level of the band corresponding to the index provided.

        elementID.gainLevels(theBand)

Possible Values

This attribute is a read/write Number (float) with a value normally ranging from 20 to +20.

Parameters

theBand

Number(long) between 1 and 10 indicating the index of the band.

Remarks

This attribute takes a parameter, but its value is specified in script code the same way as other attribute values. It cannot be specified in the EQUALIZERSETTINGS element, nor can it be used with the wmpprop listening attribute. Instead, the numbered gain level attributes are provided for these situations.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later

See also

EQUALIZERSETTINGS Element

Listening Attributes