BASS_MusicSetAmplify

Sets a MOD music's amplification level.

BOOL WINAPI BASS_MusicSetAmplify(
    HMUSIC handle,
    DWORD amp
);

Parameters
handleThe MOD music's handle.
ampAmplification level... 0 (min) - 100 (max)... the default when a MOD music is loaded is 50.

Return value
If succesful, then TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.

Error codes
BASS_ERROR_HANDLEhandle is not valid.

Remarks
As the amplification level get's higher, the sample data's range increases, and therefore, the resolution increases. But if the level is set too high, then clipping can occur, which can result in distortion of the sound.

You can check the current level of a MOD music at any time by using BASS_ChannelGetLevel. By doing so, you can decide if a MOD music's amplification level needs adjusting.

See also
BASS_ChannelGetLevel, BASS_MusicSetPanSep