Partager via


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