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


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

Метод SetEnabled включает или отключает элемент управления громкости.

Синтаксис

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

Параметры

[in] bEnable

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

[in] pguidEventContext

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

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

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

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

Требования

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

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

Интерфейс IAudioLoudness