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


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

Функция waveInStart запускает входные данные на заданном устройстве ввода waveform-audio.

Синтаксис

MMRESULT waveInStart(
  HWAVEIN hwi
);

Параметры

hwi

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

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

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

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

Комментарии

Буферы возвращаются в приложение при заполнении или при вызове функции waveInReset (элемент dwBytesRecorded в заголовке будет содержать длину данных). Если в очереди нет буферов, данные удаляются без уведомления приложения, а ввод продолжается.

Вызов этой функции, когда ввод уже запущен, не оказывает влияния, и функция возвращает ноль.

Требования

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

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

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

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