funzione midiOutReset (mmeapi.h)

La funzione midiOutReset disattiva tutte le note su tutti i canali MIDI per il dispositivo di output MIDI specificato.

Sintassi

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

Parametri

hmo

Gestire il dispositivo di output MIDI. Questo parametro può anche essere l'handle di un cast di flusso MIDI in HMIDIOUT.

Valore restituito

Restituisce MMSYSERR_NOERROR se ha 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

Tutti i buffer di output di sistema o di flusso in sospeso vengono restituiti alla funzione di callback e il flag di MHDR_DONE viene impostato nel membro dwFlags della struttura MIDIHDR .

La terminazione di un messaggio esclusivo del sistema senza inviare un byte EOX (end-of-exclusive) potrebbe causare problemi per il dispositivo di ricezione. La funzione midiOutReset non invia un byte EOX quando termina un messaggio esclusivo del sistema: le applicazioni sono responsabili dell'operazione.

Per disattivare tutte le note, viene inviato un messaggio di avviso per ogni nota in ogni canale. Inoltre, il controller di supporto viene disattivato per ogni canale.

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 (includere Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Funzioni MIDI