Unloads presets from a soundfont.

    HSOUNDFONT handle,
    int preset,
    int bank


handleThe soundfont handle.
presetPreset number to unload... -1 = all presets.
bankBank number to unload... -1 = all banks.

Return value

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

Error codes

BASS_ERROR_HANDLEhandle is not valid.
BASS_ERROR_NOTAVAILThe soundfont does not contain the specified preset, or the soundfont is memory mapped.


An unloaded preset will be loaded again when needed by a MIDI stream. Any samples that are currently being used by a MIDI stream will not be unloaded.

It is possible to partially unload presets with BASS_MIDI_FontLoadEx.

See also

BASS_MIDI_FontCompact, BASS_MIDI_FontLoad, BASS_MIDI_FontLoadEx