Méthode IConnector::GetConnectedTo (devicetopology.h)
La méthode GetConnectedTo obtient le connecteur auquel ce connecteur est connecté.
Syntaxe
HRESULT GetConnectedTo(
[out] IConnector **ppConTo
);
Paramètres
[out] ppConTo
Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IConnector de l’autre objet connecteur. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetConnectedTo échoue, *ppConTo a la valeur NULL.
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 ppConTo a lavaleur 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). |
|
La topologie de l’appareil de l’autre côté de la connexion n’est pas active (autrement dit, l’état de l’appareil n’est pas DEVICE_STATE_ACTIVE). |
Notes
Pour obtenir des exemples de code qui appellent cette méthode, consultez les implémentations des fonctions GetHardwareDeviceTopology et SelectCaptureDevice dans Topologies d’appareil.
Pour plus d’informations sur les connexions Software_IO, consultez ConnectorType, énumération. Pour plus d’informations sur la macro HRESULT_FROM_WIN32, consultez la documentation du Kit de développement logiciel (SDK) Windows. Pour plus d’informations sur l’état de l’appareil DEVICE_STATE_NOTPRESENT, consultez constantes DEVICE_STATE_XXX.
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 |