fonction midiStreamOut (mmeapi.h)

  • Article

La fonction midiStreamOut lit ou met en file d’attente un flux (mémoire tampon) de données MIDI vers un appareil de sortie MIDI.

Syntaxe

MMRESULT midiStreamOut(
  HMIDISTRM hms,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Paramètres

hms

Gérer vers un flux MIDI. Ce handle doit avoir été retourné par un appel à la fonction midiStreamOpen . Ce handle identifie l’appareil de sortie.

pmh

Pointeur vers une structure MIDIHDR qui identifie la mémoire tampon MIDI.

cbmh

Taille, en octets, de la structure MIDIHDR .

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_NOMEM
 Le système ne peut pas allouer ou verrouiller la mémoire.
MIDIERR_STILLPLAYING
 La mémoire tampon de sortie pointée vers lpMidiHdr est toujours en cours de lecture ou est mise en file d’attente à partir d’un appel précédent à midiStreamOut.
MIDIERR_UNPREPARED
 L’en-tête pointé par lpMidiHdr n’a pas été préparé.
MMSYSERR_INVALHANDLE
 Le handle d’appareil spécifié n’est pas valide.
MMSYSERR_INVALPARAM
 Le pointeur spécifié par lpMidiHdr n’est pas valide.

Notes

Avant de passer la mémoire tampon à midiStreamOpen, elle doit être préparée à l’aide de la fonction midiOutPrepareHeader .

Étant donné que la fonction midiStreamOpen ouvre l’appareil de sortie en mode suspendu, vous devez appeler la fonction midiStreamRestart avant de pouvoir utiliser midiStreamOut pour démarrer la lecture.

Pour l’implémentation actuelle de cette fonction, la mémoire tampon doit être inférieure à 64 Ko.

La mémoire tampon pointée vers la structure MIDIHDR contient un ou plusieurs événements MIDI, chacun d’eux étant défini par une structure MIDIEVENT .

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