Freigeben über


MM_MIM_MOREDATA Nachricht

Die MM_MIM_MOREDATA Nachricht wird an ein Rückruffenster gesendet, wenn eine MIDI-Nachricht von einem MIDI-Eingabegerät empfangen wird, die Anwendung jedoch MIM_DATA Nachrichten nicht schnell genug verarbeitet, um mit dem Eingabegerätetreiber Schritt zu halten. Das Fenster empfängt diese Meldung nur, wenn die Anwendung MIDI_IO_STATUS im Aufruf der midiInOpen-Funktion angibt.

MM_MIM_MOREDATA 
wParam = (WPARAM) hInput 
lParam = (LPARAM) (DWORD) lMidiMessage 

Parameter

hInput

Handle an das MIDI-Eingabegerät, das die MIDI-Nachricht empfangen hat.

lMidiMessage

Gibt die empfangene MIDI-Nachricht an. Die Nachricht wird wie folgt in einen Doppelwortwert gepackt:

Anforderung Wert BESCHREIBUNG
Hohes Wort Hochgeordnetes Byte Wird nicht verwendet.
Byte mit niedriger Reihenfolge Enthält ein zweites Byte von MIDI-Daten (bei Bedarf).
Niedriges Wort Hochgeordnetes Byte Enthält das erste Byte von MIDI-Daten (bei Bedarf).
Byte mit niedriger Reihenfolge Enthält den MIDI-status.

Die beiden MIDI-Datenbytes sind optional, je nach MIDI-status Byte.

Rückgabewert

Diese Nachricht gibt keinen Wert zurück.

Bemerkungen

Wenn Ihre Anwendung MIDI-Daten schneller empfängt, als sie verarbeiten kann, sollten Sie keinen Fensterrückrufmechanismus verwenden. Um die Geschwindigkeit zu maximieren, verwenden Sie eine Rückruffunktion, und verwenden Sie die MIM_MOREDATA Nachricht anstelle von MM_MIM_MOREDATA.

Eine Anwendung sollte nur einen minimalen Verarbeitungsaufwand für MM_MIM_MOREDATA Nachrichten ausführen. (Insbesondere sollten Anwendungen die PostMessage-Funktion nicht aufrufen, während sie MM_MIM_MOREDATA verarbeiten.) Stattdessen sollte die Anwendung die Ereignisdaten in einen Puffer platzieren und dann zurückgeben.

Wenn eine Anwendung nach einer Reihe von MM_MIM_MOREDATA Nachrichten eine MM_MIM_DATA Nachricht empfängt, hat sie eingehende MIDI-Ereignisse aufgeholt und kann zeitintensive Funktionen sicher aufrufen.

MIDI-Nachrichten, die von einem MIDI-Eingabeport empfangen werden, sind status deaktiviert. Jede Nachricht wird erweitert, um das MIDI-status-Byte einzufügen.

Diese Nachricht wird nicht gesendet, wenn eine MIDI-System-exklusive Nachricht empfangen wird. Für diese Nachricht ist kein Zeitstempel verfügbar. Für Eingabedaten mit Zeitstempel müssen Sie die Nachrichten verwenden, die an Rückruffunktionen gesendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Mmsystem.h (einschließlich Windows.h)

Siehe auch

Musical Instrument Digital Interface (MIDI)

MIDI-Nachrichten