Метод 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. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования. |
|
Служба звука Windows не запущена. |
Комментарии
Этот метод создает событие изменения тома, только если вызов метода изменяет состояние отключения сеанса с "отключено" на "включено" или "включено" на "отключено". Например, если отключение включено при вызове и вызов включает отключение звука, событие не создается.
Этот метод применяет одно и то же состояние отключения звука ко всем каналам в звуковом сеансе. Устройство конечной точки всегда применяет отключение звука равномерно ко всем каналам в сеансе. Методы IChannelAudioVolume для настройки отключенных состояний отдельных каналов отсутствуют.
Клиент может получить состояние отключения звукового сеанса, вызвав метод SimpleAudioVolume::GetMute .
Требования
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | audioclient.h |