Структура MIDIEVENT (mmeapi.h)

Статья
08/24/2023

Структура MIDIEVENT описывает событие MIDI в буфере потока.

Синтаксис

typedef struct midievent_tag {
  DWORD dwDeltaTime;
  DWORD dwStreamID;
  DWORD dwEvent;
  DWORD dwParms[1];
} MIDIEVENT;

Члены

dwDeltaTime

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

dwStreamID

Защищены; значение должно быть равно нулю.

dwEvent

Код события, параметры или длина события. Чтобы проанализировать эти сведения, используйте макросы MEVT_EVENTTYPE и MEVT_EVENTPARM . См. заметки.

dwParms[1]

Если dwEvent указывает MEVT_F_LONG и длину буфера, этот член содержит параметры для события. Данные этого параметра должны быть заполнены нулями, чтобы сохранить целое количество значений DWORD . Например, если данные события длиной пять байт, то за данными должны следовать три байта на общей сложности восемь байтов. В этом случае низкий 24 бит dwEvent будет содержать значение 5.

Если dwEvent указывает MEVT_F_SHORT, не используйте этот элемент в буфере потока.

Flag	Значение
MEVT_F_CALLBACK	Система создает обратный вызов, когда событие вот-вот будет выполнено.
MEVT_F_LONG	Событие является длительным. Низкие 24 бит dwEvent содержат длину параметров события, включенных в dwParms.
MEVT_F_SHORT	Событие является коротким. Параметры события содержатся в dwEvent с низкими 24 битами.

Остаток большого байта содержит один из следующих кодов событий:

Код события	Значение
MEVT_COMMENT	Длинное событие. Данные события будут игнорироваться. Это событие предназначено для хранения комментариев о потоке, которые могут быть полезны для разработки программ или секвенсоров, если данные потока должны храниться в файле в формате потока. В буфере этих данных нулевой байт определяет класс комментариев, а последующие байты содержат данные комментария.
MEVT_LONGMSG	Длинное событие. Данные события передаются дословно. Предполагается, что данные события являются данными, исключающими систему; то есть состояние выполнения будет очищено при выполнении события, а состояние выполнения из всех предыдущих событий не будет применяться к событиям канала в данных события. Использовать это событие для одновременной отправки группы сообщений канала не рекомендуется; Вместо этого следует использовать набор событий MEVT_SHORTMSG с нулевым разностным временем.
MEVT_NOP	Короткое событие. Это событие является заполнителем; он ничего не делает. Низкие 24 бита игнорируются. Это событие по-прежнему создает обратный вызов, если MEVT_F_CALLBACK задано в dwEvent.
MEVT_SHORTMSG	Короткое событие. Данные в низком 24 бит dwEvent являются коротким сообщением MIDI. (Описание того, как короткое сообщение упаковывается в значение DWORD, см. в функции midiOutShortMsg.)
MEVT_TEMPO	Короткое событие. Данные в низких 24 битах dwEvent содержат новый темп для следующих событий. Tempo указывается в том же формате, что и для мета-события изменения темпа в MIDI-файле, то есть в микросекундах на квартальную заметку. (Это событие не будет действовать, если для потока задан формат времени SMPTE.)
MEVT_VERSION	Длинное событие. Данные события должны содержать структуру MIDISTRMBUFFVER.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	mmeapi.h (включая Windows.h)