IAudioEndpointVolume::SetMute 方法 (endpointvolume.h)

SetMute 方法设置进入或离开音频终结点设备的音频流的静音状态。

语法

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

参数

[in] bMute

新的静音状态。 如果 bMuteTRUE,则 方法将流静音。 如果 为 FALSE,则该方法关闭静音。

[in] pguidEventContext

IAudioEndpointVolumeCallback::OnNotify 方法的上下文值。 此参数指向事件上下文 GUID。 如果 SetMute 调用更改终结点的静音状态,所有已注册 IAudioEndpointVolumeCallback 接口的客户端都将接收通知。 在 OnNotify 方法的实现中,客户端可以检查事件上下文 GUID,以发现它还是另一个客户端是 control-change 事件的源。 如果调用方为此参数提供 NULL 指针,则通知例程将接收上下文 GUID 值GUID_NULL。

返回值

如果方法成功且静音状态发生更改,该方法将返回S_OK。 如果方法成功,并且新的静音状态与以前的静音状态相同,则该方法将返回S_FALSE。 如果方法失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_OUTOFMEMORY
内存不足。

备注

有关调用 SetMute 的代码示例,请参阅 Endpoint Volume Controls

要求

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

请参阅

IAudioEndpointVolume 接口

IAudioEndpointVolumeCallback 接口

IAudioEndpointVolumeCallback::OnNotify