midiStreamOut-Funktion (mmeapi.h)
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 |
|---|---|
|
Das System kann arbeitsspeicher nicht zuordnen oder sperren. |
|
Der Ausgabepuffer, auf den lpMidiHdr verweist, wird weiterhin wiedergegeben oder wird von einem vorherigen Aufruf von midiStreamOut in die Warteschlange gestellt. |
|
Der Header, auf den lpMidiHdr verweist, wurde nicht vorbereitet. |
|
Das angegebene Gerätehandle ist ungültig. |
|
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 |