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:
- Rufen Sie mithilfe einer der unter IMMDevice Interface beschriebenen Techniken einen Verweis auf die IMMDevice-Schnittstelle für ein Audioendpunktgerät ab.
- Rufen Sie die IMMDevice::Activate-Methode auf, wobei der Parameter refiid auf REFIID IID_IDeviceTopology festgelegt 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 |