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

Метод SetLevelUniform устанавливает для всех каналов в звуковом потоке одинаковый уровень громкости в децибелах.

Синтаксис

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Параметры

[in] fLevelDB

Новый универсальный уровень в децибелах.

[in] pguidEventContext

Контекстное значение для метода IControlChangeNotify::OnNotify . Этот параметр указывает на GUID контекста события. Если вызов SetLevelUniform изменяет состояние элемента управления уровня, все клиенты, которые зарегистрировали IControlChangeNotify , будут получать уведомления. В реализации метода OnNotify клиент может проверить GUID контекста события, чтобы определить, является ли он или другой клиент источником события изменения элемента управления. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .

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

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

Код возврата	Описание
E_OUTOFMEMORY	Недостаточно памяти.

Комментарии

Если указанный универсальный уровень выходит за пределы диапазона, который сообщает метод IPerChannelDbLevel::GetLevelRange для определенного канала, вызов SetLevelUniform зажимает значение для этого канала в поддерживаемом диапазоне и завершается успешно. Последующий вызов метода IPerChannelDbLevel::GetLevel извлекает фактическое значение, используемое для этого канала.

Требования

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

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

Интерфейс IPerChannelDbLevel

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange