BASS_ChannelRemoveFX


Removes an effect on a stream, MOD music, or recording channel.

BOOL BASS_ChannelRemoveFX(
    DWORD handle,
    HFX fx
);

Parameters

handleThe channel handle... a HSTREAM, HMUSIC, or HRECORD.
fxHandle of the effect to remove from the channel. This can also be an HDSP handle to remove a DSP function.

Return value

If successful, TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_HANDLEAt least one of handle and fx is not valid.

Remarks

Depending on the DX8 effect implementation being used by the channel, the channel may have to be stopped before removing a DX8 effect from it. If necessary, that is done automatically and the channel is resumed afterwards.

BASS_ChannelRemoveDSP can also be used to remove effects.

See also

BASS_ChannelSetFX, DX8 effect implementations