Метод IAudioEndpointVolume::GetMasterVolumeLevelScalar (endpointvolume.h)
Метод GetMasterVolumeLevelScalar получает уровень громкости master аудиопотока, который входит в устройство конечной точки звука или покидает его. Уровень громкости выражается в виде нормализованного звукового сужающегося значения в диапазоне от 0,0 до 1,0.
Синтаксис
HRESULT GetMasterVolumeLevelScalar(
[out] float *pfLevel
);
Параметры
[out] pfLevel
Указатель на уровень тома master. Этот параметр указывает на переменную с плавающей точкой , в которую метод записывает уровень тома. Уровень выражается в виде нормализованного значения в диапазоне от 0,0 до 1,0.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.
Код возврата | Описание |
---|---|
|
Параметр pfLevel имеет значение NULL. |
Комментарии
Уровень тома нормализуется в диапазоне от 0,0 до 1,0, где 0,0 — минимальный уровень громкости, а 1,0 — максимальный. В этом диапазоне связь нормализованного уровня громкости с затуханием амплитуды сигнала описывается нелинейной звуковой кривой. Обратите внимание, что форма кривой может измениться в будущих версиях Windows. Дополнительные сведения о кривых с конужением звука см. в разделе Звукоудержимые регуляторы громкости.
Нормализованные уровни громкости, полученные этим методом, подходят для представления позиций элементов управления громкостями в окнах приложений и на экранных дисплеях.
Пример кода, который вызывает Метод GetMasterVolumeLevelScalar, см. в разделе Элементы управления громкостью конечных точек.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | endpointvolume.h |