Метод IAudioEndpointVolume::GetMasterVolumeLevelScalar (endpointvolume.h)

Статья
08/23/2023

Метод GetMasterVolumeLevelScalar получает уровень громкости master аудиопотока, который входит в устройство конечной точки звука или покидает его. Уровень громкости выражается в виде нормализованного звукового сужающегося значения в диапазоне от 0,0 до 1,0.

Синтаксис

HRESULT GetMasterVolumeLevelScalar(
  [out] float *pfLevel
);

Параметры

[out] pfLevel

Указатель на уровень тома master. Этот параметр указывает на переменную с плавающей точкой , в которую метод записывает уровень тома. Уровень выражается в виде нормализованного значения в диапазоне от 0,0 до 1,0.

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

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата	Описание
E_POINTER	Параметр pfLevel имеет значение NULL.

Уровень тома нормализуется в диапазоне от 0,0 до 1,0, где 0,0 — минимальный уровень громкости, а 1,0 — максимальный. В этом диапазоне связь нормализованного уровня громкости с затуханием амплитуды сигнала описывается нелинейной звуковой кривой. Обратите внимание, что форма кривой может измениться в будущих версиях Windows. Дополнительные сведения о кривых с конужением звука см. в разделе Звукоудержимые регуляторы громкости.

Нормализованные уровни громкости, полученные этим методом, подходят для представления позиций элементов управления громкостями в окнах приложений и на экранных дисплеях.

Пример кода, который вызывает Метод GetMasterVolumeLevelScalar, см. в разделе Элементы управления громкостью конечных точек.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	endpointvolume.h

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

Интерфейс IAudioEndpointVolume

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