IAudioEndpointVolume::GetChannelVolumeLevel 方法 (endpointvolume.h)

GetChannelVolumeLevel 方法获取进入或离开音频终结点设备的音频流中指定声道的音量级别(以分贝为单位)。

语法

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

参数

[in] nChannel

通道号。 如果音频流具有 n 个通道,则通道的编号从 0 到 n – 1。 若要获取流中的通道数,请调用 IAudioEndpointVolume::GetChannelCount 方法。

[out] pfLevelDB

指向 浮点 变量的指针,该方法在其中以分贝为单位写入音量级别。 若要获取从此方法获取的卷级别范围,请调用 IAudioEndpointVolume::GetVolumeRange 方法。

返回值

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

返回代码 说明
E_INVALIDARG
参数 nChannel 大于或等于流中的通道数。
E_POINTER
参数 pfLevelDBNULL

要求

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

另请参阅

IAudioEndpointVolume 接口

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange