BASS_ChannelSetDSP
Sets up a user DSP function on a stream, MOD music, or recording channel.
HDSP BASS_ChannelSetDSP(
DWORD handle,
DSPPROC *proc,
void *user,
int priority
);
Parameters
| handle | The channel handle... a HSTREAM, HMUSIC, or HRECORD. |
| proc | The callback function. |
| user | User instance data to pass to the callback function. |
| priority | The priority of the new DSP, which determines its position in the DSP chain. DSPs with higher priority are called before those with lower. |
Return value
If successful, then the new DSP's handle is returned, else 0 is returned. Use BASS_ErrorGetCode to get the error code.Error codes
| BASS_ERROR_HANDLE | handle is not a valid channel. |
Remarks
DSP functions can set and removed at any time, including mid-playback. Use BASS_ChannelRemoveDSP to remove a DSP function.Multiple DSP functions may be used per channel, in which case the order that the functions are called is determined by their priorities. Any DSPs that have the same priority are called in the order that they were added.
DSP functions can be applied to MOD musics and streams, but not samples. If you want to apply a DSP function to a sample, then you should stream the sample.