Interface IPart (devicetopology.h)

Article
03/02/2024

L’interface IPart représente une partie (connecteur ou sous-unité) d’une topologie d’appareil. Un client obtient une référence à une interface IPart en appelant la méthode IDeviceTopology ::GetPartById ou IPartsList ::GetPart , ou en appelant la méthode QueryInterface de l’interface IConnector ou ISubunit sur un objet de partie et en définissant le paramètre iid de la méthode sur REFIID IID_IPart.

Un objet avec une interface IPart peut encapsuler l’une des parties de topologie d’appareil suivantes :

Connecteur. Il s’agit d’une partie qui se connecte à un autre appareil pour former un chemin de données permettant de transmettre un flux audio entre les appareils.
Sous-unité. Il s’agit d’une partie qui traite un flux audio (par exemple, le contrôle de volume).

L’interface IPart d’un objet connecteur ou sous-unité représente les fonctions génériques communes à toutes les parties, et l’interface IConnector ou ISubunit de l’objet représente les fonctions spécifiques à un connecteur ou à une sous-unité. En outre, un composant peut prendre en charge une ou plusieurs interfaces de contrôle pour le contrôle ou la surveillance de la fonction du composant. Par exemple, le client contrôle une sous-unité de contrôle de volume via son interface IAudioVolumeLevel .

L’interface IPart fournit des méthodes permettant d’obtenir le nom, l’ID local, l’ID global et le type de partie d’un connecteur ou d’une sous-unité. En outre, IPart peut activer une interface de contrôle sur un connecteur ou une sous-unité.

Pour obtenir des exemples de code qui utilisent l’interface IPart , consultez les implémentations des fonctions GetHardwareDeviceTopology et SelectCaptureDevice dans Les topologies d’appareil.

Héritage

L’interface IPart hérite de l’interface IUnknown. IPart a également les types de membres suivants :

Méthodes

L’interface IPart a ces méthodes.


IPart ::Activate La méthode Activate active une interface spécifique à une fonction sur un connecteur ou une sous-unité.
IPart ::EnumPartsIncoming La méthode EnumPartsIncoming obtient une liste de toutes les parties entrantes, c’est-à-dire les parties qui résident sur les chemins de données amont de cette partie.
IPart ::EnumPartsOutgoing La méthode EnumPartsOutgoing récupère une liste de toutes les parties sortantes, c’est-à-dire les parties qui résident sur les chemins de données qui sont en aval de cette partie.
IPart ::GetControlInterface La méthode GetControlInterface obtient une référence à l’interface de contrôle spécifiée, si cette partie la prend en charge.
IPart ::GetControlInterfaceCount La méthode GetControlInterfaceCount obtient le nombre d’interfaces de contrôle prises en charge par cette partie.
IPart ::GetGlobalId La méthode GetGlobalId obtient l’ID global de cette partie.
IPart ::GetLocalId La méthode GetLocalId obtient l’ID local de cette partie.
IPart ::GetName La méthode GetName obtient le nom convivial de cette partie.
IPart ::GetPartType La méthode GetPartType obtient le type de composant de ce composant.
IPart ::GetSubType La méthode GetSubType obtient le sous-type de partie de ce composant.
IPart ::GetTopologyObject La méthode GetTopologyObject obtient une référence à l’interface IDeviceTopology de l’objet de topologie d’appareil qui contient cette partie.
IPart ::RegisterControlChangeCallback La méthode RegisterControlChangeCallback inscrit l’interface IControlChangeNotify, que le client implémente pour recevoir des notifications de status modifications apportées à cette partie.
IPart ::UnregisterControlChangeCallback La méthode UnregisterControlChangeCallback supprime l’inscription d’une interface IControlChangeNotify que le client a précédemment inscrite par un appel à la méthode IPart ::RegisterControlChangeCallback.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	devicetopology.h