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

Статья
08/23/2023

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

Синтаксис

HRESULT GetChannelVolumeLevelScalar(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

Параметры

[in] nChannel

Номер канала. Если аудиопоток содержит n каналов, каналы нумеруются от 0 до n–1. Чтобы получить количество каналов, вызовите метод IAudioEndpointVolume::GetChannelCount .

[out] pfLevel

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

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

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

Код возврата	Описание
E_INVALIDARG	Параметр nChannel больше или равен количеству каналов в потоке.
E_POINTER	Параметр pfLevel имеет значение NULL.

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

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

Требования


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

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

Интерфейс IAudioEndpointVolume

IAudioEndpointVolume::GetChannelCount

Share via