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 |
|---|---|
|
Le pointeur ppwstrDeviceId a la valeur NULL. |
|
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). |
|
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 |