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

BASS_ChannelRemoveDSP can also be used to remove effects.

Platform-specific

On Windows, 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.

See also

BASS_ChannelSetFX, DX8 effect implementations