Метод ISimpleAudioVolume::SetMute (audioclient.h)

Метод SetMute задает состояние отключения звука для звукового сеанса.

Синтаксис

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

Параметры

[in] bMute

Новое состояние отключения звука. Значение TRUE включает отключение звука. Значение FALSE отключает отключение звука.

[in] EventContext

Указатель на GUID контекста события. Если вызов этого метода создает событие изменения тома, диспетчер сеансов отправляет уведомления всем клиентам, которые зарегистрировали интерфейсы IAudioSessionEvents с диспетчером сеансов. Диспетчер сеансов включает значение указателя EventContext с каждым уведомлением. Получив уведомление, клиент может определить, является ли он или другой клиент источником события, проверив значение EventContext . Эта схема зависит от того, выбирает клиент значение для этого параметра, которое является уникальным среди всех клиентов в сеансе. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .

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

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

Код возврата	Описание
AUDCLNT_E_DEVICE_INVALIDATED	Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования.
AUDCLNT_E_SERVICE_NOT_RUNNING	Служба звука Windows не запущена.

Комментарии

Этот метод создает событие изменения тома, только если вызов метода изменяет состояние отключения сеанса с "отключено" на "включено" или "включено" на "отключено". Например, если отключение включено при вызове и вызов включает отключение звука, событие не создается.

Этот метод применяет одно и то же состояние отключения звука ко всем каналам в звуковом сеансе. Устройство конечной точки всегда применяет отключение звука равномерно ко всем каналам в сеансе. Методы IChannelAudioVolume для настройки отключенных состояний отдельных каналов отсутствуют.

Клиент может получить состояние отключения звукового сеанса, вызвав метод SimpleAudioVolume::GetMute .

Требования

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

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

Интерфейс IAudioSessionEvents

Интерфейс IChannelAudioVolume

Интерфейс ISimpleAudioVolume

ISimpleAudioVolume::GetMute