Partager via


fonction midiOutOpen (mmeapi.h)

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