midiConnect-Funktion (mmeapi.h)

Die midiConnect-Funktion verbindet ein MIDI-Eingabegerät mit einem MIDI-Thru- oder Ausgabegerät oder verbindet ein MIDI-Thru-Gerät mit einem MIDI-Ausgabegerät.

Syntax

MMRESULT midiConnect(
  HMIDI    hmi,
  HMIDIOUT hmo,
  LPVOID   pReserved
);

Parameter

hmi

Handle an ein MIDI-Eingabegerät oder ein MIDI-Thru-Gerät. (Für Geräte muss dieses Handle durch einen Aufruf der midiOutOpen-Funktion zurückgegeben worden sein.)

hmo

Handle an den MIDI-Ausgang oder über das Gerät.

pReserved

Reserviert; muss NULL sein.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Hinweise

Nach dem Aufruf dieser Funktion empfängt das MIDI-Eingabegerät Ereignisdaten in einer MIM_DATA Nachricht, wenn eine Nachricht mit den gleichen Ereignisdaten an den Ausgabegerätetreiber gesendet wird.

Ein thru-Treiber ist eine sondere Form des MIDI-Ausgabetreibers. Das System ermöglicht es, nur ein MIDI-Ausgabegerät mit einem MIDI-Eingabegerät zu verbinden, aber mehrere MIDI-Ausgabegeräte können mit einem MIDI-Gerät verbunden werden. Wenn das angegebene MIDI-Eingabegerät Ereignisdaten in einer MIM_DATA-Nachricht empfängt, wird eine Nachricht mit den gleichen Ereignisdaten an den angegebenen Ausgabegerätetreiber (oder über den Treiber an die Ausgabetreiber) gesendet.

Anforderungen

Weitere Informationen

MIDI-Funktionen