Image | Audio | Video |
---|---|---|
X |
Returns the track number of the first occurrence of a specified instrument in a MIDI audio.
Include file
dmbaudio.h
Syntax
>>-FindInstrument--(--handle--,--instrument--)-----------------><
Parameters (data type)
Return values (data type)
Track number that contains the first occurrence of the specified instrument name (SMALLINT); a value of -1 is returned if an instrument of the specified name is not found. NULL is returned for audio in other formats.
Examples
Find the first occurrence of PIANO in Robert Smith's MIDI audio recording stored in the sound column of the employee table:
EXEC SQL BEGIN DECLARE SECTION; short hvInstr; EXEC SQL END DECLARE SECTION; EXEC SQL SELECT FINDINSTRUMENT(SOUND, 'PIANO') INTO :hvInstr FROM EMPLOYEE WHERE NAME = 'Robert Smith';