Freigeben über


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 eines Connectors oder Untereinheitsobjekts stellt die generischen Funktionen dar, die allen Teilen gemeinsam sind, und die IConnector - oder ISubunit-Schnittstelle des Objekts stellt die Funktionen dar, die für einen Connector oder eine Untereinheit spezifisch sind. Darüber hinaus kann ein Teil eine oder mehrere Steuerungsschnittstellen unterstützen, um die Funktion des Teils zu steuern oder zu überwachen. Beispielsweise steuert der Client eine Volumesteuerungsuntereinheit über seine IAudioVolumeLevel-Schnittstelle .

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

Weitere Informationen

Kernaudioschnittstellen

DeviceTopology-API

IAudioVolumeLevel-Schnittstelle

IConnector-Schnittstelle

IDeviceTopology::GetPartById

IPartsList::GetPart

ISubunit-Schnittstelle