IPart-Schnittstelle (devicetopology.h)
Die IPart-Schnittstelle stellt einen Teil (Connector oder Untereinheit) einer Gerätetopologie dar. Ein Client ruft einen Verweis auf eine IPart-Schnittstelle ab, indem er die IDeviceTopology::GetPartById - oder IPartsList::GetPart-Methode aufruft oder die QueryInterface-Methode der IConnector - oder ISubunit-Schnittstelle für ein Teilobjekt aufruft und den iid-Parameter der Methode auf REFIID IID_IPart festlegt.
Ein Objekt mit einer IPart-Schnittstelle kann einen der folgenden Komponenten der Gerätetopologie kapseln:
- Connector. Dies ist ein Teil, der eine Verbindung mit einem anderen Gerät herstellt, um einen Datenpfad für die Übertragung eines Audiodatenstroms zwischen Geräten zu bilden.
- Untereinheit. Dies ist ein Teil, der einen Audiodatenstrom verarbeitet (z. B. Lautstärkeregelung).
Die IPart-Schnittstelle bietet Methoden zum Abrufen des Namens, der lokalen ID, der globalen ID und des Teiltyps eines Connectors oder einer Untereinheit. Darüber hinaus kann IPart eine Steuerungsschnittstelle für einen Connector oder eine Untereinheit aktivieren.
Codebeispiele, die die IPart-Schnittstelle verwenden, finden Sie in den Implementierungen der Funktionen GetHardwareDeviceTopology und SelectCaptureDevice in Gerätetopologien.
Vererbung
Die IPart-Schnittstelle erbt von der IUnknown-Schnittstelle . IPart verfügt auch über folgende Arten von Membern:
Methoden
Die IPart-Schnittstelle verfügt über diese Methoden.
| IPart::Activate Die Activate-Methode aktiviert eine funktionsspezifische Schnittstelle für einen Connector oder eine Untereinheit. |
| IPart::EnumPartsIncoming Die EnumPartsIncoming-Methode ruft eine Liste aller eingehenden Teile ab, d. h. die Teile, die sich in Datenpfaden befinden, die aus diesem Teil Upstream werden. |
| IPart::EnumPartsOutgoing Die EnumPartsOutgoing-Methode ruft eine Liste aller ausgehenden Teile ab, d. h. die Teile, die sich auf Datenpfaden befinden, die nach diesem Teil nachgelagert sind. |
| IPart::GetControlInterface Die GetControlInterface-Methode ruft einen Verweis auf die angegebene Steuerelementschnittstelle ab, wenn diese von diesem Teil unterstützt wird. |
| IPart::GetControlInterfaceCount Die GetControlInterfaceCount-Methode ruft die Anzahl der Steuerelementschnittstellen ab, die von diesem Teil unterstützt werden. |
| IPart::GetGlobalId Die GetGlobalId-Methode ruft die globale ID dieses Teils ab. |
| IPart::GetLocalId Die GetLocalId-Methode ruft die lokale ID dieses Teils ab. |
| IPart::GetName Die GetName-Methode ruft den Anzeigenamen dieses Teils ab. |
| IPart::GetPartType Die GetPartType-Methode ruft den Teiletyp dieses Teils ab. |
| IPart::GetSubType Die GetSubType-Methode ruft den Teiluntertyp dieses Teils ab. |
| IPart::GetTopologyObject Die GetTopologyObject-Methode ruft einen Verweis auf die IDeviceTopology-Schnittstelle des Gerätetopologieobjekts ab, das diesen Teil enthält. |
| IPart::RegisterControlChangeCallback Die RegisterControlChangeCallback-Methode registriert die IControlChangeNotify-Schnittstelle, die der Client implementiert, um Benachrichtigungen über status Änderungen in diesem Teil zu empfangen. |
| IPart::UnregisterControlChangeCallback Die UnregisterControlChangeCallback-Methode entfernt die Registrierung einer IControlChangeNotify-Schnittstelle, die der Client zuvor durch einen Aufruf der IPart::RegisterControlChangeCallback-Methode registriert hat. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |