Image, Audio und Video Extender Verwaltung und Programmierung

GetInstruments


Image Audio Video
  X  

Gibt die Instrumentennamen aller Instrumente in einem MIDI-Ton zurück.

Kopfdatei

dmbaudio.h

Syntax

>>-GetInstruments--(--kennung--)-------------------------------><
 

Parameter (Datentyp)

kennung (DB2AUDIO)
Name der Spalte oder Host-Variable, die die Kennung des Tons enthält.

Rückgabewerte (Datentyp)

Instrumentennamen aller Instrumente im MIDI-Ton (VARCHAR(1536)). Die Werte werden in der Reihenfolge der Spurnummer zurückgegeben (z. B. PIANO; TRUMPET; BASS). Das Ergebnis wird in n Felder aufgeteilt, wobei n die Anzahl von Spuren im MIDI-Ton ist. Wenn eine Spur kein zugeordnetes Instrument hat, ist das entsprechende Feld leer. Für andere Tonformate als MIDI wird ein Nullwert zurückgegeben.

Beispiele

Suchen aller Instrumente (d. h. Spurnummern und Instrumentennamen) in der MIDI-Tonaufzeichnung für Robert Smith. Die Tonaufzeichnung ist in der Spalte 'sound' der Tabelle 'employee' gespeichert:

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


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]