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

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

  • Статья

Функция waveInAddBuffer отправляет входной буфер на заданное устройство ввода волны и аудио. При заполнении буфера приложение получает уведомление.

Синтаксис

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

Параметры

hwi

Дескриптор для устройства ввода звукового сигнала.

pwh

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

cbwh

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

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

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

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

Комментарии

При заполнении буфера WHDR_DONE бит задается в элементе dwFlags структуры WAVEHDR .

Буфер должен быть подготовлен с помощью функции waveInPrepareHeader перед его передачей в эту функцию.

Требования

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

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

Звуковой сигнал

Функции волнообразной формы