Partager via


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 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

Voir aussi

Interfaces audio principales

DeviceTopology API

IAudioVolumeLevel, interface

IConnector Interface

IDeviceTopology ::GetPartById

IPartsList ::GetPart

ISubunit Interface