IAudioInputSelector-Schnittstelle (devicetopology.h)

Die IAudioInputSelector-Schnittstelle ermöglicht den Zugriff auf ein Hardware-Multiplexer-Steuerelement (Eingabeauswahl). Der Client ruft einen Verweis auf die IAudioInputSelector-Schnittstelle einer Untereinheit ab, indem er die IPart::Activate-Methode aufruft, wobei der Parameter refiid auf REFIID IID_IAudioInputSelector festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioInputSelector-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das eine Hardwareeingabeauswahl darstellt, unterstützt diese Schnittstelle.

Jede Eingabe eines Eingabeauswahlors wird durch die lokale ID des Teils (ein Connector oder eine Untereinheit einer Gerätetopologie) identifiziert, das eine direkte Verbindung mit der Eingabe aufweist. Eine lokale ID ist eine Zahl, die einen Teil zwischen allen Teilen einer Gerätetopologie eindeutig identifiziert.

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 IAudioInputSelector-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_MUX_SOURCE-Eigenschaft einer Untereinheit, die den UNTERTYP-GUID-Wert KSNODETYPE_MUX 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 Windows DDK-Dokumentation.

Ein Codebeispiel, das die IAudioInputSelector-Schnittstelle verwendet, finden Sie in der Implementierung der SelectCaptureDevice-Funktion in Gerätetopologien.

Vererbung

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

Methoden

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

 
IAudioInputSelector::GetSelection

Die GetSelection-Methode ruft die lokale ID des Teils ab, das mit der Auswahleingabe verbunden ist, die derzeit ausgewählt ist.
IAudioInputSelector::SetSelection

Die SetSelection-Methode wählt einen der Eingaben des Eingabeselektors aus.

Anforderungen

   
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