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 |
|---|---|
|
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 |