funzione midiOutShortMsg (mmeapi.h)

Articolo
03/05/2024

La funzione midiOutShortMsg invia un breve messaggio MIDI al dispositivo di output MIDI specificato.

Sintassi

MMRESULT midiOutShortMsg(
  HMIDIOUT hmo,
  DWORD    dwMsg
);

Parametri

hmo

Handle per il dispositivo di output MIDI. Questo parametro può anche essere l'handle di un cast di flusso MIDI a HMIDIOUT.

dwMsg

Messaggio MIDI. Il messaggio viene compresso in un valore DWORD con il primo byte del messaggio nel byte in ordine basso. Il messaggio viene compresso in questo parametro come indicato di seguito.

Word	Byte	Utilizzo
Alto	Ordine elevato	Non usato.
	Ordine basso	Secondo byte di dati MIDI (se necessario).
Basso	Ordine elevato	Primo byte di dati MIDI (se necessario).
	Ordine basso	Lo stato MIDI.

I due byte di dati MIDI sono facoltativi, a seconda del byte di stato MIDI. Quando una serie di messaggi ha lo stesso byte di stato, il byte di stato può essere omesso dai messaggi dopo il primo della serie, creando uno stato in esecuzione. Comprimere un messaggio per lo stato di esecuzione come indicato di seguito:

Word	Byte	Utilizzo
Alto	Ordine elevato	Non usato.
	Ordine basso	Non usato.
Basso	Ordine elevato	Secondo byte di dati MIDI (se necessario).
	Ordine basso	Primo byte di dati 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
MIDIERR_BADOPENMODE	L'applicazione ha inviato un messaggio senza un byte di stato a un handle di flusso.
MIDIERR_NOTREADY	L'hardware è occupato con altri dati.
MMSYSERR_INVALHANDLE	L'handle del dispositivo specificato non è valido.

Commenti

Questa funzione viene utilizzata per inviare qualsiasi messaggio MIDI, ad eccezione dei messaggi esclusivi del sistema o del flusso.

Questa funzione potrebbe non restituire finché il messaggio non viene inviato al dispositivo di output. È possibile inviare messaggi brevi mentre i flussi vengono riprodotti nello stesso dispositivo (anche se in questo caso non è possibile usare uno stato in esecuzione).

Requisiti

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

Share via