IAudioSessionEvents::OnDisplayNameChanged 方法 (audiopolicy.h)

OnDisplayNameChanged 方法通知客户端会话的显示名称已更改。

语法

HRESULT OnDisplayNameChanged(
  [in] LPCWSTR NewDisplayName,
  [in] LPCGUID EventContext
);

参数

[in] NewDisplayName

会话的新显示名称。 此参数指向包含新显示名称的以 null 结尾的宽字符字符串。 字符串在调用期间保持有效。

[in] EventContext

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

返回值

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

注解

每次调用 IAudioSessionControl::SetDisplayName 方法更改会话的显示名称时,会话管理器都会调用此方法。 Sndvol 程序使用会话的显示名称来标记会话的卷滑块。

EventContext 参数为客户端提供了一种区分它发起的显示名称更改和其他客户端发起的显示名称更改的方法。 调用 IAudioSessionControl::SetDisplayName 方法时,客户端传入其 OnDisplayNameChanged 方法的实现可以识别的 EventContext 参数值。

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

要求

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

另请参阅

IAudioSessionControl::SetDisplayName

IAudioSessionEvents 接口