MIM_MOREDATA Nachricht

Die MIM_MOREDATA Nachricht wird an eine MIDI-Eingaberückruffunktion 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 Treiber des Eingabegeräts Schritt zu halten. Die Rückruffunktion empfängt diese Meldung nur, wenn die Anwendung MIDI_IO_STATUS im Aufruf der midiInOpen-Funktion angibt.

MIM_MOREDATA 
dwParam1 = dwMidiMessage 
dwParam2 = dwTimestamp 

Parameter

dwMidiMessage

Gibt die empfangene MIDI-Nachricht an. Die Nachricht wird wie folgt in einenDWORD-Wertgepackt:

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.

dwTimestamp

Gibt den Zeitpunkt an, zu dem die Nachricht vom Eingabegerätetreiber empfangen wurde. Der Zeitstempel wird in Millisekunden angegeben, beginnend bei 0, wenn die MidiInStart-Funktion aufgerufen wurde.

Rückgabewert

Diese Nachricht gibt keinen Wert zurück.

Bemerkungen

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

Wenn eine Anwendung nach einer Reihe von MIM_MOREDATA Nachrichten eine 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.

Anforderungen

Siehe auch

Musical Instrument Digital Interface (MIDI)

MIDI-Nachrichten