Функция waveInUnprepareHeader (mmeapi.h)
Функция waveInUnprepareHeader очищает подготовку, выполняемую функцией waveInPrepareHeader . Эта функция должна вызываться после того, как драйвер устройства заполнит буфер и вернет его приложению. Эту функцию необходимо вызвать перед освобождением буфера.
Синтаксис
MMRESULT waveInUnprepareHeader(
HWAVEIN hwi,
LPWAVEHDR pwh,
UINT cbwh
);
Параметры
hwi
Обработка устройства ввода waveform-audio.
pwh
Указатель на структуру WAVEHDR , определяющую буфер для очистки.
cbwh
Размер структуры WAVEHDR (в байтах).
Возвращаемое значение
Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:
Код возврата | Описание |
---|---|
|
Указанный дескриптор устройства недопустим. |
|
Отсутствует драйвер устройства. |
|
Не удается выделить или заблокировать память. |
|
Буфер, на который указывает параметр pwh , по-прежнему находится в очереди. |
Комментарии
Эта функция дополняет функцию waveInPrepareHeader .
Эту функцию необходимо вызвать перед освобождением буфера. После передачи буфера драйверу устройства с помощью функции waveInAddBuffer необходимо подождать, пока драйвер завершит работу с буфером, прежде чем вызывать waveInUnprepareHeader. Отмена подготовки буфера, который не был подготовлен, не оказывает никакого влияния, и функция возвращает ноль.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | mmeapi.h (включая Windows.h) |
Библиотека | Winmm.lib |
DLL | Winmm.dll |