midiOutShortMsg, fonction (mmeapi.h)
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 |
|---|---|
|
L’application a envoyé un message sans octet status à un handle de flux. |
|
Le matériel est occupé avec d’autres données. |
|
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 |