Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |