IAudioAutoGainControl 介面 (devicetopology.h)

IAudioAutoGainControl 介面可讓您存取硬件自動增益控制 (AGC) 。 用戶端會呼叫 IPart：：Activate 方法，並將參數 refiid 設定為 REFIID IID_IAudioAutoGainControl，以取得子單位的 IAudioAutoGainControl 介面參考。 只有在子單位支援 IAudioAutoGainControl 介面時，IPart：：Activate 的呼叫才會成功。 只有代表硬體 AGC 函式的子單位物件才支援此介面。

大部分的 Windows 音訊配接器驅動程式都支援 Windows 驅動程式模型 (WDM) ，並使用核心串流 (KS) 属性來表示子單位中的硬體控制參數， (稱為 KS 節點) 。 IAudioAutoGainControl 介面可讓您方便存取子單位的 KSPROPERTY_AUDIO_AGC 屬性，其子單位的子類型 GUID 值為 KSNODETYPE_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