midiOutShortMsg, fonction (mmeapi.h)

Article
03/04/2024

La fonction midiOutShortMsg envoie un message MIDI court au périphérique de sortie MIDI spécifié.

Syntaxe

MMRESULT midiOutShortMsg(
  HMIDIOUT hmo,
  DWORD    dwMsg
);

Paramètres

hmo

Gérez le périphérique de sortie MIDI. Ce paramètre peut également être le handle d’un flux MIDI cast vers HMIDIOUT.

dwMsg

Message MIDI. Le message est empaqueté dans une valeur DWORD avec le premier octet du message dans l’ordre inférieur. Le message est empaqueté dans ce paramètre comme suit.

Word	Byte	Utilisation
Élevé	Ordre élevé	Non utilisé.
	Ordre bas	Deuxième octet des données MIDI (si nécessaire).
Faible	Ordre élevé	Premier octet de données MIDI (si nécessaire).
	Ordre bas	Le status MIDI.

Les deux octets de données MIDI sont facultatifs, en fonction de l’octet status MIDI. Lorsqu’une série de messages a le même status octet, le status octet peut être omis des messages après le premier de la série, ce qui crée une status en cours d’exécution. Emballez un message pour exécuter status comme suit :

Word	Byte	Utilisation
Élevé	Ordre élevé	Non utilisé.
	Ordre bas	Non utilisé.
Faible	Ordre élevé	Deuxième octet des données MIDI (si nécessaire).
	Ordre bas	Premier octet de données MIDI.

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_BADOPENMODE	L’application a envoyé un message sans octet status à un handle de flux.
MIDIERR_NOTREADY	Le matériel est occupé avec d’autres données.
MMSYSERR_INVALHANDLE	Le handle d’appareil spécifié n’est pas valide.

Remarques

Cette fonction est utilisée pour envoyer n’importe quel message MIDI, à l’exception des messages exclusifs au système ou de diffusion en continu.

Cette fonction peut ne pas retourner tant que le message n’a pas été envoyé à l’appareil de sortie. Vous pouvez envoyer des messages courts pendant la lecture de flux sur le même appareil (bien que vous ne puissiez pas utiliser un status en cours d’exécution dans ce cas).

Configuration requise

Condition requise	Valeur
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