Funzione midiInStart (mmeapi.h)
La funzione midiInStart avvia l'input MIDI nel dispositivo di input MIDI specificato.
Sintassi
MMRESULT midiInStart(
HMIDIIN hmi
);
Parametri
hmi
Handle per il dispositivo di input MIDI.
Valore restituito
Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue
| Codice restituito | Descrizione |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
Commenti
Questa funzione reimposta il timestamp su zero; I valori timestamp per i messaggi ricevuti successivamente sono relativi all'ora in cui è stata chiamata questa funzione.
Tutti i messaggi, ad eccezione dei messaggi esclusivi del sistema, vengono inviati direttamente al client quando vengono ricevuti. I messaggi esclusivi del sistema vengono inseriti nei buffer forniti dalla funzione midiInAddBuffer . Se nella coda non sono presenti buffer, i dati esclusivi del sistema vengono generati senza notifica al client e l'input continua. I buffer vengono restituiti al client quando sono pieni, quando viene ricevuto un messaggio completo esclusivo dal sistema o quando viene utilizzata la funzione midiInReset . Il membro dwBytesRecorded della struttura MIDIHDR conterrà la lunghezza effettiva dei dati ricevuti.
La chiamata a questa funzione quando l'input è già avviato non ha alcun effetto e la funzione restituisce zero.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mmeapi.h (include Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |