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 |
|---|---|
|
Il buffer a cui punta lpMidiOutHdr è ancora nella coda. |
|
L'handle del dispositivo specificato non è valido. |
|
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 |