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

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

  • Статья

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

Синтаксис

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

Параметры

hmo

Обработка на открытом устройстве вывода MIDI. Этот параметр также может содержать дескриптор MIDI-потока, если он приведен к HMIDIOUT. Этот параметр также может быть идентификатором устройства.

pdwVolume

Указатель на расположение, в котором будет содержаться текущий параметр тома. Слово нижнего порядка в этом расположении содержит параметр громкости левого канала, а слово высокого порядка — параметр правого канала. Значение 0xFFFF представляет полный объем, а значение 0x0000 — тишину.

Если устройство не поддерживает управление громкостями слева и справа, слово нижнего порядка указанного расположения содержит монотонный уровень громкости.

Возвращается любое значение, заданное с помощью функции midiOutSetVolume , независимо от того, поддерживает ли устройство это значение.

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

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

Код возврата Описание
MMSYSERR_INVALHANDLE
 Указанный дескриптор устройства недопустим.
MMSYSERR_INVALPARAM
 Указанный указатель или структура недопустимы.
MMSYSERR_NOMEM
 Системе не удается выделить или заблокировать память.
MMSYSERR_NOTSUPPORTED
 Функция не поддерживается.

Комментарии

Если используется идентификатор устройства, то результат вызова midiOutGetVolume и сведения, возвращаемые в lpdwVolume, применяются ко всем экземплярам устройства. Если используется дескриптор устройства, то результат и возвращаемые сведения применяются только к экземпляру устройства, на которое ссылается дескриптор устройства.

Не все устройства поддерживают управление громкости. Вы можете определить, поддерживает ли устройство управление громкостей, запросив устройство с помощью функции midiOutGetDevCaps и указав флаг MIDICAPS_VOLUME.

Вы также можете определить, поддерживает ли устройство управление громкостями в левом и правом каналах, запросив устройство с помощью функции midiOutGetDevCaps и указав флаг MIDICAPS_LRVOLUME.

Требования

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

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

Функции MIDI