midiOutLongMsg-Funktion (mmeapi.h)

  • Artikel

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