Interface IPart (devicetopology.h)
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 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 |