Метод IAudioEndpointVolume::SetMute (endpointvolume.h)

Статья
08/23/2023

Метод SetMute задает состояние отключения звукового потока, который входит в устройство конечной точки звука или покидает его.

Синтаксис

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

Параметры

[in] bMute

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

[in] pguidEventContext

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

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

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

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

Требования


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

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

Интерфейс IAudioEndpointVolume

Интерфейс IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify

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