COM Objects > MIDI object > Methods > MIDI.SoundFontInfoNumGet method

Remarks

Obtains a numeric information about 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.SoundFontInfoNumGet (

nUniqueId as Long,

nValue as Long

[C++]

short control.MIDI.SoundFontInfoNumGet (

long nUniqueId,

short nInfo,

long *nValue

);

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.

nInfo

The type of information that must be retrieved.

Supported values are the following:

Mnemonic constant	Value	Meaning
MIDI_SOUNDFONT_INFO_PRESETS	0	The number of presets available inside the SoundFont
MIDI_SOUNDFONT_INFO_SAMPLES_SIZE	1	The total size, expressed in bytes, of samples data inside the SoundFont
MIDI_SOUNDFONT_INFO_SAMPLES_LOADED	2	The amount of samples data currently loaded

nValue

Reference that, on return from the method call, will contain the requested value

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to get the error code
enumErrorCodes.ERR_NOERROR (0)	The method call was successful