IAudioSessionEvents::OnGroupingParamChanged 方法 (audiopolicy.h)

OnGroupingParamChanged 方法通知客户端会话的分组参数已更改。

语法

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

参数

[in] NewGroupingParam

会话的新分组参数。 此参数指向分组参数 GUID。

[in] EventContext

事件上下文值。 此值与调用方在更改会话分组参数的调用中传递给 IAudioSessionControl::SetGroupingParam 的值相同。 有关详细信息,请参阅“备注”。

返回值

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

注解

每次调用 IAudioSessionControl::SetGroupingParam 方法更改会话的分组参数时,会话管理器都会调用此方法。

EventContext 参数为客户端提供了一种方法,用于区分它发起的分组参数更改和某个其他客户端启动的分组参数更改。 调用 IAudioSessionControl::SetGroupingParam 方法时,客户端传入其 OnGroupingParamChanged 方法的实现可以识别的 EventContext 参数值。

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

要求

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

另请参阅

IAudioSessionControl::SetGroupingParam

IAudioSessionEvents 接口