IAudioEndpointVolume：：GetMasterVolumeLevelScalar 方法 (endpointvolume.h)

GetMasterVolumeLevelScalar 方法获取进入或离开音频终结点设备的音频流的主音量级别。音量级别表示为 0.0 到 1.0 范围内的规范化音频磁带值。

语法

HRESULT GetMasterVolumeLevelScalar(
  [out] float *pfLevel
);

[out] pfLevel

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

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

返回代码	说明
E_POINTER	参数 pfLevel 为 NULL。

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

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

有关调用 GetMasterVolumeLevelScalar 的代码示例，请参阅终结点卷控件。