funzione midiStreamOut (mmeapi.h)
La funzione midiStreamOut gioca o accoda un flusso (buffer) di dati MIDI a un dispositivo di output MIDI.
Sintassi
MMRESULT midiStreamOut(
HMIDISTRM hms,
LPMIDIHDR pmh,
UINT cbmh
);
Parametri
hms
Gestire un flusso MIDI. Questo handle deve essere stato restituito da una chiamata alla funzione midiStreamOpen . Questo handle identifica il dispositivo di output.
pmh
Puntatore a una struttura MIDIHDR che identifica il buffer MIDI.
cbmh
Dimensioni, in byte, della struttura MIDIHDR .
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 |
|---|---|
|
Il sistema non è in grado di allocare o bloccare la memoria. |
|
Il buffer di output a cui fa riferimento lpMidiHdr è ancora in riproduzione o viene accodato da una chiamata precedente a midiStreamOut. |
|
L'intestazione puntata da lpMidiHdr non è stata preparata. |
|
L'handle del dispositivo specificato non è valido. |
|
Il puntatore specificato da lpMidiHdr non è valido. |
Commenti
Prima che il buffer venga passato a midiStreamOpen, deve essere preparato usando la funzione midiOutPrepareHeader .
Poiché la funzione midiStreamOpen apre il dispositivo di output in modalità sospesa, è necessario chiamare la funzione midiStreamRestart prima di poter usare midiStreamOut per avviare la riproduzione.
Per l'implementazione corrente di questa funzione, il buffer deve essere inferiore a 64K.
Il buffer a cui punta la struttura MIDIHDR contiene uno o più eventi MIDI, ognuno dei quali è definito da una struttura MIDIEVENT .
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 |