IAudioEndpointVolume：：GetChannelVolumeLevelScalar 方法 (endpointvolume.h)

GetChannelVolumeLevelScalar 方法获取进入或离开音频终结点设备的指定音频流通道的规范化音频锥度音量。

语法

HRESULT GetChannelVolumeLevelScalar(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

[in] nChannel

通道号。如果音频流包含 n 个通道，则通道的编号从 0 到 n – 1。若要获取通道数，请调用 IAudioEndpointVolume：：GetChannelCount 方法。

[out] pfLevel

指向方法在其中写入卷级别的浮点变量的指针。级别表示为 0.0 到 1.0 范围内的规范化值。

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

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

卷级别规范化为 0.0 到 1.0 的范围，其中 0.0 是最小音量级别，1.0 是最大音量级别。在此范围内，规范化音量级别与信号振幅衰减的关系由非线性音频锥形曲线描述。请注意，曲线的形状可能会在 Windows 的未来版本中更改。有关音频锥形曲线的详细信息，请参阅音频锥形音量控制。

此方法检索的规范化音量级别适用于表示音量控件在应用程序窗口和屏幕显示中的位置。