IBM Books

Image, Audio, and Video Extenders Administration and Programming

NumChannels


Image Audio Video
  X X

Returns the number of recorded audio channels in a WAVE or AIFF audio, or video.

Include file

audio
dmbaudio.h

video
dmbvideo.h

Syntax

>>-NumChannels--(--handle--)-----------------------------------><
 

Parameters (data type)

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

Return values (data type)

Number of recorded audio channels in the video or WAVE or AIFF audio (SMALLINT). Returns a null value for audio in other formats.

Examples

Get the names of all audio files from the sound column of the employee table that were recorded in stereo (that is, 2 channels):

EXEC SQL BEGIN DECLARE SECTION;
 char hvAud_fname[251];
EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT FILENAME(SOUND)
     INTO :hvAud_fname
     FROM EMPLOYEE
     WHERE NUMCHANNELS(SOUND) = 2;


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