funzione midiOutUnprepareHeader (mmeapi.h)

La funzione midiOutUnprepareHeader pulisce la preparazione eseguita dalla funzione midiOutPrepareHeader .

Sintassi

MMRESULT midiOutUnprepareHeader(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parametri

hmo

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

pmh

Puntatore a una struttura MIDIHDR che identifica il buffer da pulire.

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
MIDIERR_STILLPLAYING	Il buffer a cui punta lpMidiOutHdr è ancora nella coda.
MMSYSERR_INVALHANDLE	L'handle del dispositivo specificato non è valido.
MMSYSERR_INVALPARAM	Il puntatore o la struttura specificati non è valido.

Commenti

Questa funzione è complementare alla funzione midiOutPrepareHeader . Prima di liberare il buffer, è necessario chiamare midiOutUnprepareHeader . Dopo aver passato un buffer al driver del dispositivo con la funzione midiOutLongMsg , è necessario attendere il completamento del driver del dispositivo prima di chiamare midiOutUnprepareHeader.

Unpreparing di un buffer che non è stato preparato non ha alcun effetto e la funzione restituisce MMSYSERR_NOERROR.

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

Allocazione e preparazione di blocchi di dati MIDI

Funzioni MIDI