BASS_MIDI_FontUnload

Unloads presets from a soundfont.

BOOL BASS_MIDI_FontUnload(
    HSOUNDFONT handle,
    int preset,
    int bank
);

Parameters

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.

Remarks

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