IChannelAudioVolume::GetAllVolumes 方法 (audioclient.h)

GetAllVolumes 方法检索音频会话中所有通道的音量级别。

语法

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

参数

[in] dwCount

pfVolumes 数组中的元素数。 dwCount 参数必须等于音频会话的流格式的通道数。 若要获取通道数,请调用 IChannelAudioVolume::GetChannelCount 方法。

[out] pfVolumes

指向音频会话中通道的音量级别的数组的指针。 此参数指向调用方分配的 float 数组,方法在其中写入单个通道的卷级别。 卷级别介于 0.0 到 1.0 的范围内。

返回值

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

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

备注

客户端可以调用 IChannelAudioVolume::SetAllVolumesIChannelAudioVolume::SetChannelVolume 方法,以设置音频会话中的每通道音量级别。

要求

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

另请参阅

IChannelAudioVolume 接口

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume