IAudioMute-Schnittstelle (devicetopology.h)

Die IAudioMute-Schnittstelle bietet Zugriff auf ein Hardware-Stummschaltungssteuerelement. Der Client ruft einen Verweis auf die IAudioMute-Schnittstelle einer Untereinheit ab, indem die IPart::Activate-Methode aufgerufen wird, wobei der Parameter refiid auf REFIID IID_IAudioMute festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioMute-Schnittstelle unterstützt. Diese Schnittstelle wird nur von einem Untereinheitsobjekt unterstützt, das eine Hardware-Stummschaltungssteuerungsfunktion darstellt.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwaresteuerungsparameter in Untereinheiten (als KS-Knoten bezeichnet) darzustellen. Die IAudioMute-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_MUTE-Eigenschaft einer Untereinheit, die über den GUID-Wert des Untertyps KSNODETYPE_MUTE verfügt. 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 Windows DDK-Dokumentation.

Vererbung

Die IAudioMute-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioMute verfügt auch über folgende Arten von Membern:

Methoden

Die IAudioMute-Schnittstelle verfügt über diese Methoden.

IAudioMute::GetMute Die GetMute-Methode ruft den aktuellen Zustand (aktiviert oder deaktiviert) des Stummschaltsteuerelements ab.
IAudioMute::SetMute Die SetMute-Methode aktiviert oder deaktiviert das Stummschaltungssteuerelement.

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

Weitere Informationen

Kern-Audioschnittstellen

DeviceTopology-API

IPart::Activate