Freigeben über


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
MIDIERR_BADOPENMODE
Die Anwendung hat eine Nachricht ohne ein status-Byte an ein Datenstromhandle gesendet.
MIDIERR_NOTREADY
Die Hardware ist mit anderen Daten ausgelastet.
MMSYSERR_INVALHANDLE
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

Weitere Informationen

MIDI-Funktionen