Image | Audio | Video |
---|---|---|
X |
Returns instrument name of all instruments in a MIDI audio.
Include file
dmbaudio.h
Syntax
>>-GetInstruments--(--handle--)--------------------------------><
Parameters (data type)
Return values (data type)
Instrument name of all instruments in the MIDI audio (VARCHAR(1536)). The values are returned in track number order (for example, PIANO; TRUMPET; BASS). The result is divided into n fields, where n is the number of tracks in the MIDI audio. If a track does not have an associated intrument, its field is blank. A null value is returned for audio formats other than MIDI.
Examples
Find all the instruments (that is, track numbers and instrument names) in Robert Smith's MIDI audio recording. The audio recording is stored in the sound column of the employee table:
EXEC SQL BEGIN DECLARE SECTION; char hvAud_Instr[1536]; EXEC SQL END DECLARE SECTION; EXEC SQL SELECT GETINSTRUMENTS(SOUND) INTO :hvAud_Instr FROM EMPLOYEE WHERE NAME = 'Robert Smith';