IBM Books

Image, Audio, and Video Extenders Administration and Programming

FindTrackName


Image Audio Video
  X  

Returns the number of a specified named track in a MIDI audio.

Include file

dmbaudio.h

Syntax

>>-FindTrackName--(--handle--,--trackname--)-------------------><
 

Parameters (data type)

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

trackname (VARCHAR(255))
Name of the track to be searched for. The Audio Extender will look for a track whose name exactly matches the supplied name.

Return values (data type)

Number of the named track; of the specified instrument name (SMALLINT). A value of -1 is returned if a track of the specified name is not found. A null value is returned for audio in other formats.

Examples

Determine if there is a track named WELCOME 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;
      short hvTrack;
EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT FINDTRACKNAME(SOUND,
          'WELCOME')
      INTO :hvTrack
      FROM EMPLOYEE
      WHERE NAME = 'Robert Smith';


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