IBM Books

Image, Audio, and Video Extenders Administration and Programming

GetInstruments


Image Audio Video
  X  

Returns instrument name of all instruments in a MIDI audio.

Include file

dmbaudio.h

Syntax

>>-GetInstruments--(--handle--)--------------------------------><
 

Parameters (data type)

handle (DB2AUDIO)
Column name or host variable that contains the handle of the audio.

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';


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]