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


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

Функция midiInStart запускает ввод MIDI на указанном устройстве ввода MIDI.

Синтаксис

MMRESULT midiInStart(
  HMIDIIN hmi
);

Параметры

hmi

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

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

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

Код возврата Описание
MMSYSERR_INVALHANDLE
Указанный дескриптор устройства недопустим.

Комментарии

Эта функция сбрасывает метку времени до нуля; Значения меток времени для последующих полученных сообщений относятся к времени вызова этой функции.

Все сообщения, кроме системных эксклюзивных, отправляются непосредственно клиенту при их получении. Сообщения, исключающие систему, помещаются в буферы, предоставляемые функцией midiInAddBuffer . Если в очереди нет буферов, данные, исключаемые системой, удаляются без уведомления клиента, и ввод продолжается. Буферы возвращаются клиенту при их заполнении, при получении полного сообщения, исключающего систему, или при использовании функции midiInReset . Элемент dwBytesRecorded структуры MIDIHDR будет содержать фактическую длину полученных данных.

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

Требования

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

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

Функции MIDI