Метод IAudioSessionEvents::OnSimpleVolumeChanged (audiopolicy.h)
Метод OnSimpleVolumeChanged уведомляет клиента об изменении уровня громкости или отключения звука звукового сеанса.
Синтаксис
HRESULT OnSimpleVolumeChanged(
[in] float NewVolume,
[in] BOOL NewMute,
[in] LPCGUID EventContext
);
Параметры
[in] NewVolume
Новый уровень громкости для звукового сеанса. Этот параметр является значением в диапазоне от 0,0 до 1,0, где 0,0 — тишина, а 1,0 — полный объем (без затухания).
[in] NewMute
Новое состояние отключения звука. Если задано значение TRUE, отключение звука включено. Если значение FALSE, отключение звука отключено.
[in] EventContext
Значение контекста события. Это то же значение, которое вызывающий объект передал в ISimpleAudioVolume::SetMasterVolume или ISimpleAudioVolume::SetMute в вызове, который изменил уровень громкости или состояние отключения сеанса. Дополнительные сведения см. в подразделе "Примечания".
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Диспетчер сеансов вызывает этот метод каждый раз, когда вызов метода ISimpleAudioVolume::SetMasterVolume или ISimpleAudioVolume::SetMute изменяет уровень громкости или состояние отключения сеанса.
Параметр EventContext предоставляет клиенту средства, позволяющие различать инициированное им изменение тома или отключения звука и другое. При вызове метода ISimpleAudioVolume::SetMasterVolume или ISimpleAudioVolume::SetMute клиент передает значение параметра EventContext , которое может распознать его реализация метода OnSimpleVolumeChanged .
Пример кода, реализующий методы в интерфейсе IAudioSessionEvents , см. в разделе События аудиосеанса.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | audiopolicy.h |