Функция auxSetVolume (mmeapi.h)
Функция auxSetVolume задает объем указанного вспомогательного выходного устройства.
Синтаксис
MMRESULT auxSetVolume(
UINT uDeviceID,
DWORD dwVolume
);
Параметры
uDeviceID
Идентификатор вспомогательного устройства вывода для запроса. Идентификаторы устройств определяются неявно из числа устройств, присутствующих в системе. Значения идентификаторов устройств варьируются от нуля до одного меньше числа присутствующих устройств. Используйте функцию auxGetNumDevs для определения количества вспомогательных устройств в системе.
dwVolume
Указывает новый параметр тома. Слово нижнего порядка задает параметр громкости левого канала, а слово высокого порядка — параметр правого канала. Значение 0xFFFF представляет полный объем, а значение 0x0000 — тишину.
Если устройство не поддерживает левое и правое управление громкостью, слово dwVolume нижнего порядка указывает уровень громкости, а слово высокого порядка игнорируется.
Возвращаемое значение
Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Указанный идентификатор устройства выходит за пределы диапазона. |
Комментарии
Не все устройства поддерживают управление громкостей. Чтобы определить, поддерживает ли устройство управление громкостями, используйте флаг AUXCAPS_VOLUME для проверки члена dwSupport структуры AUXCAPS (заполненной функцией auxGetDevCaps ).
Чтобы определить, поддерживает ли устройство управление громкостями в левом и правом каналах, используйте флаг AUXCAPS_LRVOLUME для проверки элемента dwSupport структуры AUXCAPS (заполненного auxGetDevCaps).
Большинство устройств не поддерживают полные 16 бит управления на уровне тома и будут использовать только биты высокого порядка запрошенного параметра тома. Например, для устройства, которое поддерживает 4 бита управления громкостей, запрошенные значения уровня тома 0x4000, 0x4FFF и 0x43BE будут создавать одинаковые параметры физического тома, 0x4000. Функция auxGetVolume вернет полный набор 16-разрядных параметров с помощью auxSetVolume.
Параметры тома интерпретируются логарифмически. Это означает, что предполагаемое увеличение объема будет одинаковым при увеличении уровня громкости с 0x5000 до 0x6000 как с 0x4000 до 0x5000.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mmeapi.h (включая Windows.h) |
| Библиотека | Winmm.lib |
| DLL | Winmm.dll |