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