IBM Books

Image, Audio, and Video Extenders Administration and Programming

GetTrackNames


Image Audio Video
  X  

Returns the name of all tracks in a MIDI audio.

Include file

dmbaudio.h

Syntax

>>-GetTrackNames--(--handle--)---------------------------------><
 

Parameters (data type)

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

Return values (data type)

Name of all tracks in the MIDI audio (VARCHAR(1536)). The values are returned in track number order (for example, PIANO TUNE; TRUMPET FANFARE). The result is divided into n fields, where n is the number of tracks in the MIDI audio. If a track does not have a name, its field is blank. A null value is returned for audio formats other than MIDI.

Examples

Get all the track numbers and track names in Robert Smith's MIDI audio recording stored in the sound column of the employee table:

EXEC SQL BEGIN DECLARE SECTION;
 char hvTracks[1536];
EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT GETTRACKNAMES(SOUND)
      INTO :hvTracks
      FROM EMPLOYEE
      WHERE NAME = 'Robert Smith';


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