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


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

Функция midiConnect подключает устройство ввода MIDI к устройству midi с помощью или выходного устройства, а также подключает устройство MIDI через устройство к устройству вывода MIDI.

Синтаксис

MMRESULT midiConnect(
  HMIDI    hmi,
  HMIDIOUT hmo,
  LPVOID   pReserved
);

Параметры

hmi

Обработка на устройстве ввода MIDI или midi через устройство. (Для устройств через этот дескриптор должен быть возвращен вызовом функции midiOutOpen .)

hmo

Обработка выходных данных MIDI или через устройство.

pReserved

Защищены; значение должно иметь значение NULL.

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

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

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

Комментарии

После вызова этой функции устройство ввода MIDI получает данные о событиях в MIM_DATA сообщении всякий раз, когда сообщение с теми же данными события отправляется в драйвер устройства вывода.

Драйвер thru — это особая форма драйвера вывода MIDI. Система позволит подключить только одно устройство вывода MIDI к устройству ввода MIDI, но несколько устройств вывода MIDI могут быть подключены к устройству MIDI через. Всякий раз, когда заданное устройство ввода MIDI получает данные о событиях в MIM_DATA сообщении, сообщение с теми же данными события отправляется заданному драйверу устройства вывода (или через драйвер через драйвер вывода в выходные драйверы).

Требования

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

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

Функции MIDI