ISimpleAudioVolume::GetMasterVolume 方法 (audioclient.h)

GetMasterVolume 方法检索音频会话的客户端音量级别。

语法

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

参数

[out] pfLevel

指向方法将客户端卷级别写入其中的 float 变量的指针。 音量级别是介于 0.0 到 1.0 范围内的值。

返回值

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

返回代码 说明
E_POINTER
参数 pfLevelNULL
AUDCLNT_E_DEVICE_INVALIDATED
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows 音频服务未运行。

注解

此方法检索会话的客户端卷级别。 这是客户端在上次调用 ISimpleAudioVolume::SetMasterVolume 方法时设置的音量级别。

要求

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

另请参阅

IAudioClient::Initialize

ISimpleAudioVolume 接口

ISimpleAudioVolume::SetMasterVolume