IAudioSessionEvents::OnIconPathChanged 方法 (audiopolicy.h)

OnIconPathChanged 方法通知客户端会话的显示图标已更改。

语法

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

参数

[in] NewIconPath

会话的新显示图标的路径。 此参数指向包含新图标路径的字符串。 字符串指针仅在调用期间保持有效。

[in] EventContext

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

返回值

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

注解

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

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

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

要求

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

另请参阅

IAudioSessionControl::SetIconPath

IAudioSessionEvents 接口