IConnector-Schnittstelle (devicetopology.h)

Die IConnector-Schnittstelle stellt einen Verbindungspunkt zwischen Komponenten dar. Der Client ruft einen Verweis auf eine IConnector-Schnittstelle durch Aufrufen der IDeviceTopology::GetConnector - oder IConnector::GetConnectedTo-Methode oder durch Aufrufen der IPart::QueryInterface-Methode mit parameter iid auf REFIID IID_IConnector.

Eine IConnector-Schnittstelle instance kann Folgendes darstellen:

  • Eine Audiobuchse auf einem Hardwareteil
  • Eine interne Verbindung mit einem integrierten Endpunktgerät (z. B. ein integriertes Mikrofon in einem Laptopcomputer)
  • Eine Softwareverbindung, die über DMA-Übertragungen implementiert wird
Die Methoden in der IConnector-Schnittstelle können verschiedene Arten von Connectors beschreiben. Ein Connector verfügt über einen Typ (eine ConnectorType-Enumerationskonstante ) und einen Untertyp (eine GUID, die von der IPart::GetSubType-Methode abgerufen wurde).

Ein Teil in einer Gerätetopologie kann entweder ein Connector oder eine Untereinheit sein. Die IPart-Schnittstelle stellt Methoden bereit, die für Connectors und Untereinheiten gemeinsam sind.

Codebeispiele, die die IConnector-Schnittstelle verwenden, finden Sie in den Implementierungen der Funktionen GetHardwareDeviceTopology und SelectCaptureDevice in Gerätetopologien.

Vererbung

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

Methoden

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

 
IConnector::ConnectTo

Die ConnectTo-Methode verbindet diesen Connector mit einem Connector in einem anderen Gerätetopologieobjekt.
IConnector::D isconnect

Die Disconnect-Methode trennt diesen Connector von einem anderen Connector.
IConnector::GetConnectedTo

Die GetConnectedTo-Methode ruft den Connector ab, mit dem dieser Connector verbunden ist.
IConnector::GetConnectorIdConnectedTo

Die GetConnectorIdConnectedTo-Methode ruft ggf. die globale ID des Connectors ab, mit dem dieser Connector verbunden ist.
IConnector::GetDataFlow

Die GetDataFlow-Methode ruft die Richtung des Datenflusses über diesen Connector ab.
IConnector::GetDeviceIdConnectedTo

Die GetDeviceIdConnectedTo-Methode ruft ggf. den Gerätebezeichner des Audiogeräts ab, mit dem dieser Connector verbunden ist.
IConnector::GetType

Die GetType-Methode ruft den Typ dieses Connectors ab.
IConnector::IsConnected

Die IsConnected-Methode gibt an, ob dieser Connector mit einem anderen Connector verbunden ist.

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

Kernaudioschnittstellen

DeviceTopology-API

IConnector::GetConnectedTo

IDeviceTopology::GetConnector