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:
Rückgabecode | Beschreibung |
---|---|
|
Das angegebene Eingabegerät ist bereits mit einem Ausgabegerät verbunden. |
|
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 |