Copyright © 2001-2018 MultiMedia Soft

MIDI.SoundFontPresetDescGet method

Previous pageReturn to chapter overviewNext page

Remarks

 

Obtains a the friendly description of a preset available inside the given MIDI SoundFont.

 

For further details about the use of MIDI protocol see the MIDI object section and the How to deal with MIDI protocol tutorial.

 

 

Syntax

 

[Visual Basic]

control.MIDI.SoundFontPresetDescGet (

nUniqueId as Long,

nPreset as Long,

nBank as Long

) as BSTR


 

[C++]

BSTR control.MIDI.SoundFontPresetDescGet (

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.

This parameter can be set to 0 when the request is related to the system default SoundFont.

nPreset

The preset number which may be in the range from 0 to 127. If this value is set to -1 the information will be related to the first encountered preset

nBank

The bank number. If this value is set to -1 the information will be related to the first encountered bank

 

 

Return value

 

Value

Meaning

 

 

Empty string

An error occurred (see the LastError property for further error details)

Valid string

String containing the preset friendly description. The returned string is empty when the preset is not available inside the given SoundFont