Freigeben über


midiInStart-Funktion (mmeapi.h)

Die midiInStart-Funktion startet die MIDI-Eingabe auf dem angegebenen MIDI-Eingabegerät.

Syntax

MMRESULT midiInStart(
  HMIDIIN hmi
);

Parameter

hmi

Handle mit dem MIDI-Eingabegerät.

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

Diese Funktion setzt den Zeitstempel auf 0 zurück. Zeitstempelwerte für nachfolgende empfangene Nachrichten beziehen sich auf den Zeitpunkt, zu dem diese Funktion aufgerufen wurde.

Alle Nachrichten mit Ausnahme von systemspezifischen Nachrichten werden direkt an den Client gesendet, wenn sie empfangen werden. Systemspezifische Nachrichten werden in den Puffern platziert, die von der midiInAddBuffer-Funktion bereitgestellt werden. Wenn keine Puffer in der Warteschlange vorhanden sind, werden die systemspezifischen Daten ohne Benachrichtigung an den Client weggeworfen, und die Eingabe wird fortgesetzt. Puffer werden an den Client zurückgegeben, wenn sie voll sind, wenn eine vollständige systemspezifische Nachricht empfangen wurde oder wenn die midiInReset-Funktion verwendet wird. Das dwBytesRecorded-Element der MIDIHDR-Struktur enthält die tatsächliche Länge der empfangenen Daten.

Das Aufrufen dieser Funktion, wenn die Eingabe bereits gestartet wurde, wirkt sich nicht aus, und die Funktion gibt null zurück.

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

Weitere Informationen

MIDI-Funktionen