fonction midiOutOpen (mmeapi.h)

Article
08/24/2023

La fonction midiOutOpen ouvre un appareil de sortie MIDI pour la lecture.

Syntaxe

MMRESULT midiOutOpen(
  LPHMIDIOUT phmo,
  UINT       uDeviceID,
  DWORD_PTR  dwCallback,
  DWORD_PTR  dwInstance,
  DWORD      fdwOpen
);

Paramètres

phmo

Pointeur vers un handle HMIDIOUT . Cet emplacement est rempli avec un handle identifiant le périphérique de sortie MIDI ouvert. Le handle est utilisé pour identifier l’appareil dans les appels à d’autres fonctions de sortie MIDI.

uDeviceID

Identificateur de l’appareil de sortie MIDI à ouvrir.

dwCallback

Pointeur vers une fonction de rappel, un handle d’événement, un identificateur de thread ou un handle d’une fenêtre ou d’un thread appelé pendant la lecture MIDI pour traiter les messages liés à la progression de la lecture. Si aucun rappel n’est souhaité, spécifiez NULL pour ce paramètre. Pour plus d’informations sur la fonction de rappel, consultez MidiOutProc.

dwInstance

L’utilisateur instance données passées au rappel. Ce paramètre n’est pas utilisé avec les rappels ou threads de fenêtre.

fdwOpen

Indicateur de rappel pour l’ouverture de l’appareil. Il peut s’agir des valeurs suivantes.

Valeur	Signification
CALLBACK_EVENT	Le paramètre dwCallback est un handle d’événement. Ce mécanisme de rappel est destiné uniquement à la sortie.
CALLBACK_FUNCTION	Le paramètre dwCallback est une adresse de fonction de rappel.
CALLBACK_NULL	Il n’existe aucun mécanisme de rappel. Cette valeur est le paramètre par défaut.
CALLBACK_THREAD	Le paramètre dwCallback est un identificateur de thread.
CALLBACK_WINDOW	Le paramètre dwCallback est un handle de fenêtre.

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_NODEVICE	Aucun port MIDI n’a été trouvé. Cette erreur se produit uniquement lorsque le mappeur est ouvert.
MMSYSERR_ALLOCATED	La ressource spécifiée est déjà allouée.
MMSYSERR_BADDEVICEID	L’identificateur d’appareil spécifié est hors de portée.
MMSYSERR_INVALPARAM	Le pointeur ou la structure spécifiés n’est pas valide.
MMSYSERR_NOMEM	Le système ne peut pas allouer ou verrouiller la mémoire.

Notes

Pour déterminer le nombre d’appareils de sortie MIDI présents dans le système, utilisez la fonction midiOutGetNumDevs . L’identificateur d’appareil spécifié par wDeviceID varie de zéro à un inférieur au nombre d’appareils présents. MIDI_MAPPER peut également être utilisé comme identificateur d’appareil.

Si une fenêtre ou un thread est choisi pour recevoir des informations de rappel, les messages suivants sont envoyés à la procédure de fenêtre ou au thread pour indiquer la progression de la sortie MIDI : MM_MOM_OPEN, MM_MOM_CLOSE et MM_MOM_DONE.

Si une fonction est choisie pour recevoir des informations de rappel, les messages suivants sont envoyés à la fonction pour indiquer la progression de la sortie MIDI : MOM_OPEN, MOM_CLOSE et MOM_DONE.

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