Méthode IConnector ::GetDeviceIdConnectedTo (devicetopology.h)

La méthode GetDeviceIdConnectedTo obtient l’identificateur d’appareil de l’appareil audio, le cas échéant, auquel ce connecteur est connecté.

Syntaxe

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

Paramètres

[out] ppwstrDeviceId

Pointeur vers un pointeur de chaîne dans lequel la méthode écrit l’adresse d’une chaîne à caractères larges terminée par null qui contient l’identificateur d’appareil de l’appareil connecté. La méthode alloue le stockage pour la chaîne. L’appelant est responsable de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Si l’appel GetDeviceIdConnectedTo échoue, *ppwstrDeviceId a la valeur NULL. Pour plus d’informations sur CoTaskMemFree, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_POINTER	Le pointeur ppwstrDeviceId a la valeur NULL.
E_NOTFOUND	Ce connecteur n’est pas connecté ou l’autre côté de la connexion n’est pas une autre topologie d’appareil (par exemple, une connexion Software_IO).
E_MEMORY	Mémoire insuffisante.

Remarques

L’identificateur d’appareil obtenu à partir de cette méthode peut être utilisé comme paramètre d’entrée de la méthode IMMDeviceEnumerator ::GetDevice .

Cette méthode est fonctionnellement équivalente à la série d’appels de méthode suivante, mais plus efficace que :

• Appelez la méthode IConnector ::GetConnectedTo pour obtenir l’interface IConnector du connecteur « à ».
• Appelez la méthode IConnector ::QueryInterface (avec le paramètre iid défini sur REFIID IID_IPart) pour obtenir l’interface IPart du connecteur « à ».
• Appelez la méthode IPart ::GetTopologyObject pour obtenir l’interface IDeviceTopology de l’appareil « à » (l’appareil qui contient le connecteur « à »).
• Appelez la méthode IDeviceTopology ::GetDeviceId pour obtenir l’ID de l’appareil « à ».

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

IConnector Interface

IMMDeviceEnumerator ::GetDevice