fonction midiConnect (mmeapi.h)

Article
08/24/2023

La fonction midiConnect connecte un périphérique d’entrée MIDI à un appareil de thru ou de sortie MIDI, ou connecte un périphérique de thru MIDI à un appareil de sortie MIDI.

Syntaxe

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

Paramètres

hmi

Gérez vers un périphérique d’entrée MIDI ou un appareil d’entrée MIDI. (Pour les appareils via, ce handle doit avoir été retourné par un appel à la fonction midiOutOpen .)

hmo

Gérez vers la sortie MIDI ou l’appareil par le temps.

pReserved

Réservés au; doit avoir la valeur NULL.

Valeur retournée

Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Description
MIDIERR_NOTREADY	Le périphérique d’entrée spécifié est déjà connecté à un périphérique de sortie.
MMSYSERR_INVALHANDLE	Le handle d’appareil spécifié n’est pas valide.

Notes

Après avoir appelé cette fonction, l’appareil d’entrée MIDI reçoit les données d’événement dans un message MIM_DATA chaque fois qu’un message contenant les mêmes données d’événement est envoyé au pilote de périphérique de sortie.

Un pilote thru est une forme spéciale de pilote de sortie MIDI. Le système n’autorise qu’un seul appareil de sortie MIDI à être connecté à un périphérique d’entrée MIDI, mais plusieurs périphériques de sortie MIDI peuvent être connectés à un périphérique de sortie MIDI. Chaque fois que le périphérique d’entrée MIDI donné reçoit des données d’événement dans un message de MIM_DATA, un message contenant les mêmes données d’événement est envoyé au pilote de périphérique de sortie donné (ou par le biais du pilote de connexion aux pilotes de sortie).

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mmeapi.h (inclure Windows.h)
Bibliothèque	Winmm.lib
DLL	Winmm.dll

Voir aussi

Fonctions MIDI