iAudioTreble 接口 (devicetopology.h)

  • 项目

IAudioTreble 接口提供对硬件高音级别控件的访问。 客户端通过调用 IPart：：Activate 方法获取对子单元的 IAudioTreble 接口的引用，并将参数 refiid 设置为 REFIID IID_IAudioTreble。 仅当子单元支持 IAudioTreble 接口时，对 IPart：：Activate 的调用才会成功。 只有表示用于控制每个通道中高音频率级别的硬件函数的子单位对象才支持此接口。

IAudioTreble 接口提供每个通道控件，用于设置和获取音频流中高音频率的增益或衰减级别。 如果高音级别硬件控件只能衰减音频流中的声道，则任何声道的最大高音级别为 0 dB。 如果高音级控件可以提供增益 (放大) ，则最大高音级别大于 0 dB。

大多数 Windows 音频适配器驱动程序支持 Windows 驱动程序模型 (WDM) ，并使用内核流式处理 (KS) 属性来表示子单元中的硬件控制参数， (称为 KS 节点) 。 IAudioTreble 接口提供了对子单元的 KSPROPERTY_AUDIO_TREBLE 属性的便捷访问，该子单元的子类型 GUID 值为 KSNODETYPE_TONE。 若要获取子单元的子类型 GUID，请调用 IPart：：GetSubType 方法。 有关 KS 属性和 KS 节点类型的详细信息，请参阅 Windows DDK 文档。

继承

IAudioTreble 接口继承自 IPerChannelDbLevel 接口。

要求

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

另请参阅

核心音频接口

DeviceTopology API

IPart：：Activate

IPerChannelDbLevel 接口