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

Статья
08/23/2023

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

Синтаксис

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

Параметры

[in] nChannel

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

[out] pfLevelDB

Указатель на переменную с плавающей точкой , в которую метод записывает уровень громкости в децибелах. Чтобы получить диапазон уровней тома, полученных из этого метода, вызовите метод IAudioEndpointVolume::GetVolumeRange .

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

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

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

Требования


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

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

Интерфейс IAudioEndpointVolume

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange

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