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::SetMasterVolumeISimpleAudioVolume::SetMute 的值相同。 有关详细信息,请参阅“备注”。

返回值

如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。

注解

每次调用 ISimpleAudioVolume::SetMasterVolumeISimpleAudioVolume::SetMute 方法更改会话的音量级别或静音状态时,会话管理器都会调用此方法。

EventContext 参数为客户端提供了一种方法,用于区分它发起的卷或静音更改和其他客户端发起的音量或静音更改。 调用 ISimpleAudioVolume::SetMasterVolumeISimpleAudioVolume::SetMute 方法时,客户端传入其 OnSimpleVolumeChanged 方法的实现可以识别的 EventContext 参数值。

有关在 IAudioSessionEvents 接口中实现方法的代码示例,请参阅 音频会话事件

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 audiopolicy.h

另请参阅

IAudioSessionEvents 接口

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute