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

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

  • Статья

Метод SetLevel задает уровень громкости указанного канала в децибелах.

Синтаксис

HRESULT SetLevel(
  [in] UINT    nChannel,
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Параметры

[in] nChannel

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

[in] fLevelDB

Новый уровень объема в децибелах. Положительное значение представляет собой выигрыш, а отрицательное значение — затухание.

[in] pguidEventContext

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

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

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

Код возврата Описание
E_INVALIDARG
 Параметр nChannel выходит за пределы диапазона.
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Если вызывающий объект задает значение для fLevelDB , которое является точным значением пошагового выполнения, метод SetLevel завершается успешно. Последующий вызов метода IPerChannelDbLevel::GetLevel вернет либо заданное значение, либо одно из следующих значений:

  • Если заданное значение было меньше минимального, метод GetLevel возвращает минимальное значение.
  • Если заданное значение было выше максимального, метод GetLevel возвращает максимальное значение.
  • Если заданное значение находилось между двумя пошаговыми значениями, метод GetLevel возвращает значение, которое может быть следующим значением шага выше или значением шага под заданным значением; Относительные расстояния от заданного значения до соседних шаговых значений не имеют значения. Значение, возвращаемое методом GetLevel , зависит от того, какое значение оказывает большее влияние на путь сигнала.

Требования

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

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

Интерфейс IPerChannelDbLevel

IPerChannelDbLevel::GetChannelCount

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange