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

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

  • Статья

Функция midiOutReset отключает все заметки во всех MIDI-каналах для указанного устройства вывода MIDI.

Синтаксис

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

Параметры

hmo

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

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

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

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

Комментарии

Все ожидающие системные или потоковые выходные буферы возвращаются в функцию обратного вызова, а флаг MHDR_DONE устанавливается в элементе dwFlags структуры MIDIHDR .

Завершение сообщения, исключающего систему, без отправки EOX (конец эксклюзивного) байта может привести к проблемам для принимающего устройства. Функция midiOutReset не отправляет байт EOX, когда завершает сообщение, исключаемое системой, — за это отвечают приложения.

Чтобы отключить все заметки, отправляется сообщение об отключении заметок для каждой заметки в каждом канале. Кроме того, контроллер поддержки отключен для каждого канала.

Требования

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

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

Функции MIDI