Метод IPerChannelDbLevel::GetLevelRange (devicetopology.h)

Статья
08/23/2023

Метод GetLevelRange получает диапазон (в децибелах) уровня громкости указанного канала.

Синтаксис

HRESULT GetLevelRange(
  [in]  UINT  nChannel,
  [out] float *pfMinLevelDB,
  [out] float *pfMaxLevelDB,
  [out] float *pfStepping
);

Параметры

[in] nChannel

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

[out] pfMinLevelDB

Указатель на переменную float , в которую метод записывает минимальный уровень тома в децибелах.

[out] pfMaxLevelDB

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

[out] pfStepping

Указатель на переменную с плавающей точкой , в которую метод записывает значение шага между последовательными уровнями тома в диапазоне *pfMinLevelDB в *pfMaxLevelDB. Если разница между максимальным и минимальным уровнями объема является децибелами , а диапазон делится на n шагов (интервалы равномерного размера), то объем может иметь n + 1 дискретных уровней, а размер шага между последовательными уровнями — d / n децибел.

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

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

Код возврата	Описание
E_INVALIDARG	Параметр nChannel выходит за пределы диапазона.
E_POINTER	Указатель pfminLevelDB, pfmaxLevelDB или pfmaxLevelDB имеет значение NULL.

Требования

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

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

Интерфейс IPerChannelDbLevel

IPerChannelDbLevel::GetChannelCount