Interface IDeviceTopology (devicetopology.h)

L’interface IDeviceTopology permet d’accéder à la topologie d’un appareil audio. La topologie d’un périphérique d’adaptateur audio se compose des chemins de données qui mènent aux appareils de point de terminaison audio et des points de contrôle situés le long des chemins d’accès. Un appareil de point de terminaison audio a également une topologie, mais elle est triviale, comme expliqué dans Topologies d’appareil. Un client obtient une référence à l’interface IDeviceTopology pour un appareil de point de terminaison audio en procédant comme suit :

1. En utilisant l’une des techniques décrites dans IMMDevice Interface, obtenez une référence à l’interface IMMDevice pour un appareil de point de terminaison audio.
2. Appelez la méthode IMMDevice::Activate avec refiid de paramètre défini sur REFIID IID_IDeviceTopology.

Après avoir obtenu l’interface IDeviceTopology pour un appareil de point de terminaison audio, une application peut explorer les topologies des périphériques d’adaptateur audio auxquels l’appareil de point de terminaison est connecté.

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

Héritage

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

Méthodes

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

IDeviceTopology::GetConnector La méthode GetConnector obtient le connecteur spécifié par un numéro de connecteur.
IDeviceTopology::GetConnectorCount La méthode GetConnectorCount obtient le nombre de connecteurs dans l’objet de topologie d’appareil.
IDeviceTopology::GetDeviceId La méthode GetDeviceId obtient l’identificateur d’appareil de l’appareil représenté par l’objet de topologie d’appareil.
IDeviceTopology::GetPartById La méthode GetPartById obtient un composant identifié par son ID local.
IDeviceTopology::GetSignalPath La méthode GetSignalPath obtient une liste de parties dans le chemin du signal qui lie deux parties, si le chemin existe.
IDeviceTopology::GetSubunit La méthode GetSubunit obtient la sous-unité spécifiée par un numéro de sous-unité.
IDeviceTopology::GetSubunitCount La méthode GetSubunitCount obtient le nombre de sous-unités dans la topologie de l’appareil.

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

IMMDevice::Activate