Функция midiInStart (mmeapi.h)
Функция midiInStart запускает ввод MIDI на указанном устройстве ввода MIDI.
Синтаксис
MMRESULT midiInStart(
HMIDIIN hmi
);
Параметры
hmi
Дескриптор для устройства ввода MIDI.
Возвращаемое значение
Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:
Код возврата | Описание |
---|---|
|
Указанный дескриптор устройства недопустим. |
Комментарии
Эта функция сбрасывает метку времени до нуля; Значения меток времени для последующих полученных сообщений относятся к времени вызова этой функции.
Все сообщения, кроме системных эксклюзивных, отправляются непосредственно клиенту при их получении. Сообщения, исключающие систему, помещаются в буферы, предоставляемые функцией midiInAddBuffer . Если в очереди нет буферов, данные, исключаемые системой, удаляются без уведомления клиента, и ввод продолжается. Буферы возвращаются клиенту при их заполнении, при получении полного сообщения, исключающего систему, или при использовании функции midiInReset . Элемент dwBytesRecorded структуры MIDIHDR будет содержать фактическую длину полученных данных.
Вызов этой функции, когда ввод уже запущен, не оказывает влияния, и функция возвращает ноль.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | mmeapi.h (включая Windows.h) |
Библиотека | Winmm.lib |
DLL | Winmm.dll |