midiStreamOpen, fonction (mmeapi.h)

Article
08/24/2023

La fonction midiStreamOpen ouvre un flux MIDI pour la sortie. Par défaut, l’appareil est ouvert en mode suspendu. Le handle de flux récupéré par cette fonction doit être utilisé dans toutes les références ultérieures au flux.

Syntaxe

MMRESULT midiStreamOpen(
  LPHMIDISTRM phms,
  LPUINT      puDeviceID,
  DWORD       cMidi,
  DWORD_PTR   dwCallback,
  DWORD_PTR   dwInstance,
  DWORD       fdwOpen
);

Paramètres

phms

Pointeur vers une variable pour contenir le handle de flux lorsque la fonction est retournée.

puDeviceID

Pointeur vers un identificateur d’appareil. L’appareil est ouvert pour le compte du flux et fermé à nouveau lorsque le flux est fermé.

cMidi

Réservés au; doit être 1.

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 mécanisme de rappel n’est souhaité, spécifiez NULL pour ce paramètre.

dwInstance

Propres à l’application instance données retournées à l’application avec chaque fonction de rappel.

fdwOpen

Indicateur de rappel pour l’ouverture de l’appareil. L’un des indicateurs de rappel suivants doit être spécifié.

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 procédure de rappel. Pour la signature de rappel, consultez MidiOutProc.
CALLBACK_NULL	Il n’existe aucun mécanisme de rappel. Il s'agit du 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
MMSYSERR_BADDEVICEID	L’identificateur d’appareil spécifié est hors limites.
MMSYSERR_INVALPARAM	Le paramètre handle ou flags donné n’est pas valide.
MMSYSERR_NOMEM	Le système ne peut pas allouer ou verrouiller la mémoire.

Spécifications


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

Partager via