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
E_INVALIDARG	Le paramètre nIndex est hors limites.
E_POINTER	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

Voir aussi

IConnector, interface

IDeviceTopology, interface

IDeviceTopology ::GetConnectorCount