IKsJackDescription2-Schnittstelle (devicetopology.h)

Die IKsJackDescription2-Schnittstelle stellt Informationen zu den Buchsen oder internen Anschlüssen bereit, die eine physische Verbindung zwischen einem Gerät auf einem Audioadapter und einem externen oder internen Endpunktgerät (z. B. mikrofon oder CD-Player) bereitstellen.

Neben dem Abrufen von Jack-Informationen wie dem Verbindungstyp wird die IKsJackDescription in erster Linie verwendet, um zu melden, ob die Buchse mit dem Gerät verbunden war. Wenn der verbundene Gerätetreiber in Windows 7 IKsJackDescription2 unterstützt, kann der Audiostapel oder eine Anwendung diese Schnittstelle verwenden, um zusätzliche Informationen zu Klinken zu erhalten. Dies umfasst die Erkennungsfunktion der Buchse und wenn sich das Format des Geräts dynamisch geändert hat.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwarebeschreibungsparameter in Connectors darzustellen (als KS-Pins bezeichnet). Die IKsJackDescription2-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_JACK_DESCRIPTION2-Eigenschaft eines Connectors für ein Endpunktgerät. Weitere Informationen zu KS-Eigenschaften und KS-Pins finden Sie in der Windows DDK-Dokumentation.

Eine Anwendung ruft einen Verweis auf die IKsJackDescription2-Schnittstelle eines Teils ab, indem die IPart::Activate-Methode aufgerufen wird, wobei der Parameter refiid auf REFIIDIID_IKsJackDescription2 festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn das Teil die IKsJackDescription2-Schnittstelle unterstützt. Diese Schnittstelle wird nur von einem Teilobjekt unterstützt, das einen Bridge-Pin-Connector für ein KS-Filtergerätetopologieobjekt darstellt.

Ein Codebeispiel finden Sie unter IKsJackDescription.

Vererbung

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

Methoden

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

IKsJackDescription2::GetJackCount Die GetJackCount-Methode ruft die Anzahl der Buchsen am Connector ab, die zum Herstellen einer Verbindung mit einem Endpunktgerät erforderlich sind.
IKsJackDescription2::GetJackDescription2 Die GetJackDescription2-Methode ruft die Beschreibung einer angegebenen Audiobuchse ab.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Weitere Informationen

Kern-Audioschnittstellen

DeviceTopology-API

IPart::Activate