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

Vedi anche

Funzioni MIDI