MIDI.SoundFontLoad method |
|
Remarks
Loads in memory presets from a sound font allowing to avoid CPU spikes during playback of MIDI streams. Loaded presets can be unloaded at a later from memory using the MIDI.SoundFontUnload method.
For further details about the use of MIDI protocol see the MIDIMan class section and the How to deal with MIDI protocol tutorial.
Syntax
[Visual Basic] control.MIDI.SoundFontLoad ( nUniqueId As Long, nPreset as Long, nBank as Long ) as enumErrorCodes |
[C++] short control.MIDI.SoundFontLoad ( long nUniqueId, long nPreset, long nBank ); |
Parameter |
Description |
|
|
nUniqueId |
Number representing the unique identifier of the MIDI SoundFont as returned by a previous call to one between the MIDI.SoundFontInit or MIDI.SoundFontInitFromMemory or MIDI.SoundFontInitFromMemory methods. |
nPreset |
The preset number to load. If this parameter is set to -1, all presets are loaded. |
nBank |
The bank number to load. If this parameter is set to -1, all banks are loaded. |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred (see the LastError property for further error details) |
enumErrorCodes.NOERROR (0) |
The method call was successful. |