Share via

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

  • Статья

Функция midiOutLongMsg отправляет эксклюзивное системное сообщение MIDI на указанное устройство вывода MIDI.

Синтаксис

MMRESULT midiOutLongMsg(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Параметры

hmo

Дескриптор вывода MIDI. Этот параметр также может быть дескриптором потока MIDI, приведения к HMIDIOUT.

pmh

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

cbmh

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

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

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

Код возврата Описание
MIDIERR_NOTREADY
 Оборудование занято другими данными.
MIDIERR_UNPREPARED
 Буфер, на который указывает lpMidiOutHdr , не подготовлен.
MMSYSERR_INVALHANDLE
 Указанный дескриптор устройства недопустим.
MMSYSERR_INVALPARAM
 Указанный указатель или структура недопустимы.

Комментарии

Перед передачей буфера в midiOutLongMsg его необходимо подготовить с помощью функции midiOutPrepareHeader . Драйвер устройства вывода MIDI определяет, отправляются ли данные синхронно или асинхронно.

Требования

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

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

Функции MIDI