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

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

  • Статья

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

Синтаксис

MMRESULT midiOutShortMsg(
  HMIDIOUT hmo,
  DWORD    dwMsg
);

Параметры

hmo

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

dwMsg

Сообщение MIDI. Сообщение упаковывается в значение DWORD с первым байтом сообщения в нижнем байте. Сообщение упаковывается в этот параметр следующим образом.

Word Byte Использование
Высокий Высокий порядок Не используется.
Низкий порядок Второй байт данных MIDI (при необходимости).
Низкий Высокий порядок Первый байт данных MIDI (при необходимости).
Низкий порядок Состояние MIDI.
 

Два байта данных MIDI являются необязательными в зависимости от байта состояния MIDI. Если ряд сообщений имеет одинаковый байт состояния, байт состояния можно опустить в сообщениях после первого в ряду, создавая состояние выполнения. Упакуйте сообщение о состоянии выполнения следующим образом:

Word Byte Использование
Высокий Высокий порядок Не используется.
Низкий порядок Не используется.
Низкий Высокий порядок Второй байт данных MIDI (при необходимости).
Низкий порядок Первый байт данных MIDI.

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

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

Код возврата Описание
MIDIERR_BADOPENMODE
 Приложение отправило сообщение без байта состояния в дескриптор потока.
MIDIERR_NOTREADY
 Оборудование занято другими данными.
MMSYSERR_INVALHANDLE
 Указанный дескриптор устройства недопустим.

Комментарии

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

Эта функция может не возвращать сообщение, пока сообщение не будет отправлено на устройство вывода. Вы можете отправлять короткие сообщения во время воспроизведения потоков на одном устройстве (хотя в этом случае нельзя использовать состояние выполнения).

Требования

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

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

Функции MIDI