IAudioEndpointVolumeCallback::OnNotify 方法 (endpointvolume.h)

OnNotify 方法通知客户端音频终结点设备的音量级别或静音状态已更改。

语法

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

参数

[in] pNotify

指向卷通知数据的指针。 此参数指向 AUDIO_VOLUME_NOTIFICATION_DATA 类型的结构。

返回值

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

注解

pNotify 参数指向一个结构,该结构描述发起 OnNotify 调用的卷更改事件。 此结构包含事件上下文 GUID。 此 GUID 使客户端能够区分卷 (或静音) 它发起的更改和其他客户端发起的更改。 当调用更改流的卷级别的 IAudioEndpointVolume 方法时,客户端会将指针传递到其 OnNotify 方法的实现可以识别的事件上下文 GUID。 pNotify 指向的结构包含此上下文 GUID。 如果更改卷级别的客户端为指向事件上下文 GUID 的指针提供 NULL 指针值,则 pNotify 指向的结构中的事件上下文 GUID 的值GUID_NULL。

Windows 7(系统的卷用户界面)在更改系统中的卷时未指定GUID_NULL。 第三方 OSD 应用程序可以区分系统卷用户界面导致的主卷控制更改和其他卷更改(例如内置卷控制处理程序的更改)。

有关实现 OnNotify 方法的代码示例,请参阅 Endpoint Volume Controls

要求

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

另请参阅

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume 接口

IAudioEndpointVolumeCallback 接口