Méthode IDeviceTopology ::GetConnector (devicetopology.h)
La méthode GetConnector obtient le connecteur spécifié par un numéro de connecteur.
Syntaxe
HRESULT GetConnector(
[in] UINT nIndex,
[out] IConnector **ppConnector
);
Paramètres
[in] nIndex
Numéro de connecteur. Si une topologie d’appareil contient n connecteurs, les connecteurs sont numérotés de 0 à n – 1. Pour obtenir le nombre de connecteurs dans la topologie de l’appareil, appelez la méthode IDeviceTopology ::GetConnectorCount .
[out] ppConnector
Pointeur vers une variable pointeur dans laquelle la méthode écrit l’adresse de l’interface IConnector de l’objet connecteur. Grâce à cette méthode, l’appelant obtient une référence comptabilisée à l’interface. L’appelant est chargé de libérer l’interface, quand elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetConnector échoue, *ppConnector 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 paramètre nIndex est hors limites. |
|
Le pointeur ppConnector a la valeur NULL. |
Remarques
Pour obtenir des exemples de code qui appellent la méthode GetConnector , consultez les implémentations des fonctions GetHardwareDeviceTopology et SelectCaptureDevice dans Device Topologies.
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 |