midiStreamOut-Funktion (mmeapi.h)

  • Artikel

Die midiStreamOut-Funktion gibt einen Stream (Puffer) von MIDI-Daten an einem MIDI-Ausgabegerät ab oder stellt diese in die Warteschlange.

Syntax

MMRESULT midiStreamOut(
  HMIDISTRM hms,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parameter

hms

Handle zu einem MIDI-Stream. Dieses Handle muss durch einen Aufruf der midiStreamOpen-Funktion zurückgegeben worden sein. Dieses Handle identifiziert das Ausgabegerät.

pmh

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

cbmh

Größe der MIDIHDR-Struktur in Bytes.

Rückgabewert

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

Rückgabecode Beschreibung
MMSYSERR_NOMEM
 Das System kann arbeitsspeicher nicht zuordnen oder sperren.
MIDIERR_STILLPLAYING
 Der Ausgabepuffer, auf den lpMidiHdr verweist, wird weiterhin wiedergegeben oder wird von einem vorherigen Aufruf von midiStreamOut in die Warteschlange gestellt.
MIDIERR_UNPREPARED
 Der Header, auf den lpMidiHdr verweist, wurde nicht vorbereitet.
MMSYSERR_INVALHANDLE
 Das angegebene Gerätehandle ist ungültig.
MMSYSERR_INVALPARAM
 Der von lpMidiHdr angegebene Zeiger ist ungültig.

Hinweise

Bevor der Puffer an midiStreamOpen übergeben wird, muss er mithilfe der midiOutPrepareHeader-Funktion vorbereitet werden.

Da die midiStreamOpen-Funktion das Ausgabegerät im Angehaltenen Modus öffnet, müssen Sie die MidiStreamRestart-Funktion aufrufen, bevor Sie midiStreamOut verwenden können, um die Wiedergabe zu starten.

Für die aktuelle Implementierung dieser Funktion muss der Puffer kleiner als 64 KB sein.

Der Puffer, auf den die MIDIHDR-Struktur verweist, enthält ein oder mehrere MIDI-Ereignisse, die jeweils durch eine MIDIEVENT-Struktur definiert 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ßlich Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

MIDI-Funktionen