IMFSimpleAudioVolume::SetMasterVolume 方法 (mfidl.h)

设置主卷级别。

语法

HRESULT SetMasterVolume(
  [in] float fLevel
);

parameters

[in] fLevel

卷级别。 音量表示为衰减级别,其中 0.0 表示静音,1.0 表示完整音量 (无衰减) 。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
MF_E_NOT_INITIALIZED
音频呈现器未初始化。
MF_E_STREAMSINK_REMOVED
音频呈现器已从管道中删除。

注解

应用程序外部的事件可以更改主卷级别。 例如,用户可以从系统卷控制程序 (SndVol) 更改卷。 如果外部事件更改主音量,音频呈现器将发送 一个 MEAudioSessionVolumeChanged 事件,媒体会话会将该事件转发到应用程序。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 mfidl.h
Library Mfuuid.lib

另请参阅

IMFSimpleAudioVolume

流式处理音频呈现器