Interface IConnector (devicetopology.h)

L’interface IConnector représente un point de connexion entre les composants. Le client obtient une référence à une interface IConnector en appelant la méthode IDeviceTopology::GetConnector ou IConnector::GetConnectedTo , ou en appelant la méthode IPart::QueryInterface avec le paramètre iid défini sur REFIID IID_IConnector.

Une interface IConnector instance peut représenter :

• Une prise audio sur un morceau de matériel
• Connexion interne à un appareil de point de terminaison intégré (par exemple, un microphone intégré dans un ordinateur portable)
• Connexion logicielle implémentée via des transferts DMA

Les méthodes de l’interface IConnector peuvent décrire différents types de connecteurs. Un connecteur a un type (constante d’énumération ConnectorType ) et un sous-type (guid obtenu à partir de la méthode IPart::GetSubType ).

Une partie d’une topologie d’appareil peut être un connecteur ou une sous-unité. L’interface IPart fournit des méthodes communes aux connecteurs et sous-unités.

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

Héritage

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

Méthodes

L’interface IConnector possède ces méthodes.

IConnector::ConnectTo La méthode ConnectTo connecte ce connecteur à un connecteur dans un autre objet de topologie d’appareil.
IConnector::D isconnect La méthode Disconnect déconnecte ce connecteur d’un autre connecteur.
IConnector::GetConnectedTo La méthode GetConnectedTo obtient le connecteur auquel ce connecteur est connecté.
IConnector::GetConnectorIdConnectedTo La méthode GetConnectorIdConnectedTo obtient l’ID global du connecteur, le cas échéant, auquel ce connecteur est connecté.
IConnector::GetDataFlow La méthode GetDataFlow obtient la direction du flux de données via ce connecteur.
IConnector::GetDeviceIdConnectedTo La méthode GetDeviceIdConnectedTo obtient l’identificateur d’appareil de l’appareil audio, le cas échéant, auquel ce connecteur est connecté.
IConnector::GetType La méthode GetType obtient le type de ce connecteur.
IConnector::IsConnected La méthode IsConnected indique si ce connecteur est connecté à un autre connecteur.

Spécifications

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

IConnector::GetConnectedTo

IDeviceTopology::GetConnector