midiOutShortMsg-Funktion (mmeapi.h)

Artikel
02/29/2024

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