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

Статья
02/29/2024

Функция 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	Указанный дескриптор устройства недопустим.

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

Требования

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

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

Функции MIDI

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