IAudioStreamVolume::GetAllVolumes 方法 (audioclient.h)
GetAllVolumes 方法检索音频流中所有声道的音量级别。
语法
HRESULT GetAllVolumes(
[in] UINT32 dwCount,
[out] float *pfVolumes
);
参数
[in] dwCount
pfVolumes 数组中的元素数。 dwCount 参数必须等于流格式中的通道数。 若要获取通道数,请调用 IAudioStreamVolume::GetChannelCount 方法。
[out] pfVolumes
指向音频流中声道音量级别的数组的指针。 此参数指向调用方分配的 float 数组,该方法在其中写入单个通道的音量级别。 音量级别范围为 0.0 到 1.0。
返回值
如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
参数 dwCount 不等于流中的通道数。 |
|
参数 pfVolumes 为 NULL。 |
|
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。 |
|
Windows 音频服务未运行。 |
注解
客户端可以调用 IAudioStreamVolume::SetAllVolumes 或 IAudioStreamVolume::SetChannelVolume 方法,以设置音频流中的每声道音量级别。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | audioclient.h |
另请参阅
IAudioStreamVolume::GetChannelCount