IDeviceTopology-Schnittstelle (devicetopology.h)

Die IDeviceTopology-Schnittstelle ermöglicht den Zugriff auf die Topologie eines Audiogeräts. Die Topologie eines Audioadaptergeräts besteht aus den Datenpfaden, die zu und von Audioendpunktgeräten führen, und den Kontrollpunkten, die sich entlang der Pfade befinden. Ein Audioendpunktgerät verfügt auch über eine Topologie, ist jedoch trivial, wie unter Gerätetopologien erläutert. Ein Client ruft einen Verweis auf die IDeviceTopology-Schnittstelle für ein Audioendpunktgerät ab, indem er die folgenden Schritte ausführt:

1. Rufen Sie mithilfe einer der unter IMMDevice Interface beschriebenen Techniken einen Verweis auf die IMMDevice-Schnittstelle für ein Audioendpunktgerät ab.
2. Rufen Sie die IMMDevice::Activate-Methode auf, wobei der Parameter refiid auf REFIID IID_IDeviceTopology festgelegt ist.

Nach dem Abrufen der IDeviceTopology-Schnittstelle für ein Audioendpunktgerät kann eine Anwendung die Topologien der Audioadaptergeräte untersuchen, mit denen das Endpunktgerät verbunden ist.

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

Vererbung

Die IDeviceTopology-Schnittstelle erbt von der IUnknown-Schnittstelle . IDeviceTopology verfügt auch über die folgenden Typen von Membern:

Methoden

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

IDeviceTopology::GetConnector Die GetConnector-Methode ruft den Connector ab, der durch eine Connectornummer angegeben wird.
IDeviceTopology::GetConnectorCount Die GetConnectorCount-Methode ruft die Anzahl der Connectors im Device-Topologie-Objekt ab.
IDeviceTopology::GetDeviceId Die GetDeviceId-Methode ruft den Gerätebezeichner des Geräts ab, das durch das Device-Topologie-Objekt dargestellt wird.
IDeviceTopology::GetPartById Die GetPartById-Methode ruft einen Teil ab, der durch die lokale ID identifiziert wird.
IDeviceTopology::GetSignalPath Die GetSignalPath-Methode ruft eine Liste von Teilen im Signalpfad ab, die zwei Teile miteinander verknüpft, wenn der Pfad vorhanden ist.
IDeviceTopology::GetSubunit Die GetSubunit-Methode ruft die Untereinheit ab, die durch eine Untereinheitsnummer angegeben wird.
IDeviceTopology::GetSubunitCount Die GetSubunitCount-Methode ruft die Anzahl der Untereinheiten in der Gerätetopologie ab.

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

IMMDevice::Activate