ISimpleAudioVolume::GetMasterVolume 方法 (audioclient.h)
GetMasterVolume 方法检索音频会话的客户端音量级别。
语法
HRESULT GetMasterVolume(
[out] float *pfLevel
);
参数
[out] pfLevel
指向方法将客户端卷级别写入其中的 float 变量的指针。 音量级别是介于 0.0 到 1.0 范围内的值。
返回值
如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
参数 pfLevel 为 NULL。 |
|
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。 |
|
Windows 音频服务未运行。 |
注解
此方法检索会话的客户端卷级别。 这是客户端在上次调用 ISimpleAudioVolume::SetMasterVolume 方法时设置的音量级别。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | audioclient.h |