midiOutReset-Funktion (mmeapi.h)

Die midiOutReset-Funktion deaktiviert alle Noten auf allen MIDI-Kanälen für das angegebene MIDI-Ausgabegerät.

Syntax

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

Parameter

hmo

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

Rückgabewert

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

Rückgabecode	Beschreibung
MMSYSERR_INVALHANDLE	Das angegebene Gerätehandle ist ungültig.

Hinweise

Alle ausstehenden system exclusiven oder Streamausgabepuffer werden an die Rückruffunktion zurückgegeben, und das flag MHDR_DONE wird im dwFlags-Member der MIDIHDR-Struktur festgelegt.

Das Beenden einer system exklusiven Nachricht, ohne ein EOX-Byte (End-of-Exclusive) zu senden, kann zu Problemen für das empfangende Gerät führen. Die midiOutReset-Funktion sendet kein EOX-Byte, wenn sie eine system exklusive Nachricht beendet . Dafür sind Anwendungen verantwortlich.

Um alle Notizen zu deaktivieren, wird eine Notiz für jede Notiz in jedem Kanal gesendet. Darüber hinaus wird der Sustain-Controller für jeden Kanal deaktiviert.

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