midiOutShortMsg-Funktion (mmeapi.h)
Die midiOutShortMsg-Funktion sendet eine kurze MIDI-Nachricht an das angegebene MIDI-Ausgabegerät.
Syntax
MMRESULT midiOutShortMsg(
HMIDIOUT hmo,
DWORD dwMsg
);
Parameter
hmo
Handle zum MIDI-Ausgabegerät. Dieser Parameter kann auch das Handle eines MIDI-Streams sein, der in HMIDIOUT umgewandelt wird.
dwMsg
MIDI-Nachricht. Die Nachricht wird in einen DWORD-Wert mit dem ersten Byte der Nachricht im Byte mit niedriger Reihenfolge gepackt. Die Nachricht wird wie folgt in diesen Parameter gepackt.
| Word | Byte | Verbrauch |
|---|---|---|
| High | Hohe Ordnung | Wird nicht verwendet. |
| Niedrige Reihenfolge | Das zweite Byte der MIDI-Daten (bei Bedarf). | |
| Niedrig | Hohe Ordnung | Das erste Byte der MIDI-Daten (bei Bedarf). |
| Niedrige Reihenfolge | Der MIDI-status. |
Die beiden MIDI-Datenbytes sind je nach MIDI-status Byte optional. Wenn eine Reihe von Nachrichten das gleiche status Byte aufweist, kann das status Byte in Nachrichten nach der ersten in der Reihe weggelassen werden, wodurch eine ausgeführte status erstellt wird. Packen Sie eine Nachricht zum Ausführen status wie folgt:
| Word | Byte | Verbrauch |
|---|---|---|
| High | Hohe Ordnung | Wird nicht verwendet. |
| Niedrige Reihenfolge | Wird nicht verwendet. | |
| Niedrig | Hohe Ordnung | Das zweite Byte der MIDI-Daten (bei Bedarf). |
| Niedrige Reihenfolge | Das erste Byte der MIDI-Daten. |
Rückgabewert
Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Anwendung hat eine Nachricht ohne ein status-Byte an ein Datenstromhandle gesendet. |
|
Die Hardware ist mit anderen Daten ausgelastet. |
|
Das angegebene Gerätehandle ist ungültig. |
Hinweise
Diese Funktion wird verwendet, um alle MIDI-Nachrichten zu senden, mit Ausnahme von system-exklusiven oder Streamnachrichten.
Diese Funktion wird möglicherweise erst zurückgegeben, wenn die Nachricht an das Ausgabegerät gesendet wurde. Sie können kurze Nachrichten senden, während Streams auf demselben Gerät wiedergegeben werden (obwohl Sie in diesem Fall keine ausgeführte status verwenden können).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mmeapi.h (Einschließen von Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |