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