Метод IAudioAutoGainControl::SetEnabled (devicetopology.h)

  • Статья

Метод SetEnabled включает или отключает AGC.

Синтаксис

HRESULT SetEnabled(
  [in] BOOL    bEnable,
  [in] LPCGUID pguidEventContext
);

Параметры

[in] bEnable

Новое состояние AGC. Если этот параметр имеет значение TRUE (ненулевое), метод включает AGC. Значение FALSE отключает AGC.

[in] pguidEventContext

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

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

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

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

Комментарии

Отключенный элемент управления AGC работает в сквозном режиме. В этом режиме звуковой поток проходит через элемент управления без изменений.

Требования

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

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

Интерфейс IAudioAutoGainControl