Поделиться через


Функция waveInUnprepareHeader (mmeapi.h)

Функция waveInUnprepareHeader очищает подготовку, выполняемую функцией waveInPrepareHeader . Эта функция должна вызываться после того, как драйвер устройства заполнит буфер и вернет его приложению. Эту функцию необходимо вызвать перед освобождением буфера.

Синтаксис

MMRESULT waveInUnprepareHeader(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Параметры

hwi

Обработка устройства ввода waveform-audio.

pwh

Указатель на структуру WAVEHDR , определяющую буфер для очистки.

cbwh

Размер структуры WAVEHDR (в байтах).

Возвращаемое значение

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата Описание
MMSYSERR_INVALHANDLE
Указанный дескриптор устройства недопустим.
MMSYSERR_NODRIVER
Отсутствует драйвер устройства.
MMSYSERR_NOMEM
Не удается выделить или заблокировать память.
WAVERR_STILLPLAYING
Буфер, на который указывает параметр pwh , по-прежнему находится в очереди.

Комментарии

Эта функция дополняет функцию waveInPrepareHeader .

Эту функцию необходимо вызвать перед освобождением буфера. После передачи буфера драйверу устройства с помощью функции waveInAddBuffer необходимо подождать, пока драйвер завершит работу с буфером, прежде чем вызывать waveInUnprepareHeader. Отмена подготовки буфера, который не был подготовлен, не оказывает никакого влияния, и функция возвращает ноль.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmeapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Waveform Audio

Функции waveform