funzione midiOutShortMsg (mmeapi.h)
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 |
|---|---|
|
L'applicazione ha inviato un messaggio senza un byte di stato a un handle di flusso. |
|
L'hardware è occupato con altri dati. |
|
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 |