Share via

funzione midiStreamOut (mmeapi.h)

  • Articolo

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
MMSYSERR_NOMEM
 Il sistema non è in grado di allocare o bloccare la memoria.
MIDIERR_STILLPLAYING
 Il buffer di output a cui fa riferimento lpMidiHdr è ancora in riproduzione o viene accodato da una chiamata precedente a midiStreamOut.
MIDIERR_UNPREPARED
 L'intestazione puntata da lpMidiHdr non è stata preparata.
MMSYSERR_INVALHANDLE
 L'handle del dispositivo specificato non è valido.
MMSYSERR_INVALPARAM
 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

Vedi anche

Funzioni MIDI