IAudioEndpointVolume::VolumeStepUp 方法 (endpointvolume.h)

VolumeStepUp 方法将进入或离开音频终结点设备的音频流的音量级别递增一步。

语法

HRESULT VolumeStepUp(
  [in] LPCGUID pguidEventContext
);

参数

[in] pguidEventContext

IAudioEndpointVolumeCallback::OnNotify 方法的上下文值。 此参数指向事件上下文 GUID。 如果 VolumeStepUp 调用更改终结点的卷级别,所有已注册具有该终结点 的 IAudioEndpointVolumeCallback 接口的客户端都将收到通知。 在 OnNotify 方法的实现中,客户端可以检查事件上下文 GUID,以发现它还是另一个客户端是卷更改事件的源。 如果调用方为此参数提供 NULL 指针,则客户端的通知方法将收到 NULL 上下文指针。

返回值

如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。

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

备注

若要获取当前卷步骤和卷范围内的总步骤数,请调用 IAudioEndpointVolume::GetVolumeStepInfo 方法。

如果音量级别已处于音量范围内的最高步骤,则对 VolumeStepUp 的调用不起作用,并且S_OK返回状态代码。

相邻步骤之间的连续间隔不一定代表线性信号振幅或分贝的统一音量增量。 在 Windows Vista 中, VolumeStepUp 将步骤索引与音量级别 (信号振幅) 定义为音频锥形曲线的关系。 请注意,曲线的形状可能会在 Windows 的未来版本中更改。 有关音频锥形曲线的详细信息,请参阅 音频锥形音量控制

要求

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

请参阅

IAudioEndpointVolume 接口

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback 接口

IAudioEndpointVolumeCallback::OnNotify