iAudioVolumeLevel 接口 (devicetopology.h)
IAudioVolumeLevel 接口提供对硬件卷控件的访问。 客户端通过调用 IPart::Activate 方法获取对子单元的 IAudioVolumeLevel 接口的引用,并将参数 refiid 设置为 REFIID IID_IAudioVolumeLevel。 仅当子单元支持 IAudioVolumeLevel 接口时,对 IPart::Activate 的调用才会成功。 只有表示硬件卷级控件的子单元对象才支持此接口。
IAudioVolumeLevel 接口提供每个通道控件,用于设置和获取音频流中的增益或衰减级别。 如果音量级硬件控件只能衰减音频流中的通道,则任何通道的最大音量级别为 0 dB。 如果音量级控件可以提供增益 (放大) ,则最大音量级别大于 0 dB。
大多数 Windows 音频适配器驱动程序支持 Windows 驱动程序模型 (WDM) ,并使用内核流式处理 (KS) 属性来表示子单元中的硬件控制参数 (称为 KS 节点) 。 IAudioVolumeLevel 接口提供对子单元的 KSPROPERTY_AUDIO_VOLUMELEVEL 属性的便捷访问,该子单元的子类型 GUID 值为 KSNODETYPE_VOLUME。 若要获取子单元的子类型 GUID,请调用 IPart::GetSubType 方法。 有关 KS 属性和 KS 节点类型的详细信息,请参阅 Windows DDK 文档。
继承
IAudioVolumeLevel 接口继承自 IPerChannelDbLevel 接口。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | devicetopology.h |