IAudioAutoGainControl 接口 (devicetopology.h)

  • 项目

IAudioAutoGainControl 接口提供对硬件自动增益控制 (AGC) 的访问。 客户端通过调用 IPart：：Activate 方法（参数 refiid 设置为 REFIID IID_IAudioAutoGainControl）来获取对子单元的 IAudioAutoGainControl 接口的引用。 仅当子单位支持 IAudioAutoGainControl 接口时，对 IPart：：Activate 的调用才会成功。 只有表示硬件 AGC 函数的子单元对象才支持此接口。

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

继承

IAudioAutoGainControl 接口继承自 IUnknown 接口。 IAudioAutoGainControl 也具有以下类型的成员：

方法

IAudioAutoGainControl 接口具有这些方法。

 
IAudioAutoGainControl：：GetEnabled

GetEnabled 方法获取当前状态， (AGC) 启用或禁用。
IAudioAutoGainControl：：SetEnabled

SetEnabled 方法启用或禁用 AGC。

要求

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

另请参阅

核心音频接口

DeviceTopology API

IPart：：Activate