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


Метод IAudioMute::SetMute (devicetopology.h)

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

Синтаксис

HRESULT SetMute(
  [in] BOOL    bMuted,
  [in] LPCGUID pguidEventContext
);

Параметры

[in] bMuted

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

[in] pguidEventContext

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

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

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

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

Требования

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

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

Интерфейс IAudioMute