funzione waveInUnprepareHeader (mmeapi.h)
La funzione waveInUnprepareHeader pulisce la preparazione eseguita dalla funzione waveInPrepareHeader . Questa funzione deve essere chiamata dopo che il driver del dispositivo riempie un buffer e lo restituisce all'applicazione. Prima di liberare il buffer, è necessario chiamare questa funzione.
Sintassi
MMRESULT waveInUnprepareHeader(
HWAVEIN hwi,
LPWAVEHDR pwh,
UINT cbwh
);
Parametri
hwi
Gestire il dispositivo di input waveform-audio.
pwh
Puntatore a una struttura WAVEHDR che identifica il buffer da pulire.
cbwh
Dimensioni, in byte, della struttura WAVEHDR .
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 |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
|
Non è presente alcun driver di dispositivo. |
|
Impossibile allocare o bloccare la memoria. |
|
Il buffer a cui fa riferimento il parametro pwh è ancora nella coda. |
Commenti
Questa funzione integra la funzione waveInPrepareHeader .
Prima di liberare il buffer, è necessario chiamare questa funzione. Dopo aver passato un buffer al driver del dispositivo con la funzione waveInAddBuffer , è necessario attendere il completamento del driver prima di chiamare waveInUnprepareHeader. Unpreparing di un buffer che non è stato preparato non ha alcun effetto e la funzione restituisce zero.
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 (includere Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |