Метод IAudioSessionEvents::OnSimpleVolumeChanged (audiopolicy.h)

Статья
08/22/2023

Метод 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

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

Интерфейс IAudioSessionEvents

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute

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