midiConnect-Funktion (mmeapi.h)

  • Artikel

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:

Rückgabecode Beschreibung
MIDIERR_NOTREADY
 Das angegebene Eingabegerät ist bereits mit einem Ausgabegerät verbunden.
MMSYSERR_INVALHANDLE
 Das angegebene Gerätehandle ist ungültig.

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

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mmeapi.h (Einschließen von Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

MIDI-Funktionen