IAudioAutoGainControl-Schnittstelle (devicetopology.h)
Die IAudioAutoGainControl-Schnittstelle bietet Zugriff auf eine hardwareautomatische Verstärkungssteuerung (AGC). Der Client ruft einen Verweis auf die IAudioAutoGainControl-Schnittstelle einer Untereinheit ab, indem er die IPart::Activate-Methode aufruft, deren Parameter refiid auf REFIID IID_IAudioAutoGainControl festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioAutoGainControl-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das eine Hardware-AGC-Funktion darstellt, unterstützt diese Schnittstelle.
Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (Windows Driver Model, WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwaresteuerungsparameter in Untereinheiten (als KS-Knoten bezeichnet) darzustellen. Die IAudioAutoGainControl-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_AGC-Eigenschaft einer Untereinheit, die den GUID-Untertypwert KSNODETYPE_AGC hat. Um die Untertyp-GUID einer Untereinheit abzurufen, rufen Sie die IPart::GetSubType-Methode auf. Weitere Informationen zu KS-Eigenschaften und KS-Knotentypen finden Sie in der Dokumentation zu Windows DDK.
Vererbung
Die IAudioAutoGainControl-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioAutoGainControl verfügt auch über folgende Membertypen:
Methoden
Die IAudioAutoGainControl-Schnittstelle verfügt über diese Methoden.
| IAudioAutoGainControl::GetEnabled Die GetEnabled-Methode ruft den aktuellen Status (aktiviert oder deaktiviert) der AGC ab. |
| IAudioAutoGainControl::SetEnabled Die SetEnabled-Methode aktiviert oder deaktiviert die AGC. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |