AAM_EQPreset

This function adjusts the built-in audio controls.

Syntax

DWORD AAM_EQPreset( DWORD dwFlag LONG *plValue);

Parameters

dwFlag

Specifies a bitmask fo flags. It is one of the following values:

AAM_FLAG_SET

If set, the function sets the EQ to the desired preset equalization. If not set, this function retrieves the current EQ settings.

AAM_FLAG_RANGE

To get the range of values that can be set, combine the selected flag with AAM_FLAG_RANGE. The function returns only a single value in plValue but the actual value is from -plValue to +plValue. However, a plValue of 1 indicates that the value of the property is binary and can only be activated (nonzero) and deactivated (0).

AAM_FLAG_TREBLE

Gets or sets the level of the treble control.

AAM_FLAG_BASS

Gets or sets the level of the bass control.

AAM_FLAG_LOUDNESS

Gets or sets the level of the loudness control (usually 0 or 1).

AAM_FLAG_EQBYPASS

Gets or sets the EQ bypass status. When activated, this bypasses the treble, bass, loudness and any other equalization controls except de-emphasis.

AAM_FLAG_DEEMPHASIS

Gets or sets the status of the de-emphasis filter. When activated, this provides compensation for compact discs recorded with pre-emphasis.

plValue

Pointer to a value to get or set, depending on the dwFlag setting.

Return Values

Zero indicates success. AAM_ERR_INVALIDPARAM indicates an invalid parameter. AAM_ERR_DEVICEFAIL indicates failure. AAM_ERR_NOTSUPPORTED indicates that the device does not support this feature.

Remarks

To set a property combine the selected flag with AAM_FLAG_SET and set plValue to the desired value. To get a property combine the selected flag with AAM_FLAG_GET and plValue will be set to the current value when the call returns.