midiOutLongMsg-Funktion (mmeapi.h)

Artikel
08/24/2023

Die midiOutLongMsg-Funktion sendet eine system exklusive MIDI-Nachricht an das angegebene MIDI-Ausgabegerät.

Syntax

MMRESULT midiOutLongMsg(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parameter

hmo

Handle zum MIDI-Ausgabegerät. Dieser Parameter kann auch das Handle eines MIDI-Streams sein, der in HMIDIOUT umgewandelt wird.

pmh

Zeiger auf eine MIDIHDR-Struktur , die den MIDI-Puffer identifiziert.

cbmh

Größe der MIDIHDR-Struktur in Byte.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
MIDIERR_NOTREADY	Die Hardware ist mit anderen Daten ausgelastet.
MIDIERR_UNPREPARED	Der Puffer, auf den lpMidiOutHdr verweist, wurde nicht vorbereitet.
MMSYSERR_INVALHANDLE	Das angegebene Gerätehandle ist ungültig.
MMSYSERR_INVALPARAM	Der angegebene Zeiger oder die angegebene Struktur ist ungültig.

Hinweise

Bevor der Puffer an midiOutLongMsg übergeben wird, muss er mithilfe der MidiOutPrepareHeader-Funktion vorbereitet werden. Der MIDI-Ausgabegerätetreiber bestimmt, ob die Daten synchron oder asynchron gesendet werden.

Anforderungen


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

Freigeben über