Metodo IDeviceTopology::GetConnector (devicetopology.h)

Il metodo GetConnector ottiene il connettore specificato da un numero di connettore.

Sintassi

HRESULT GetConnector(
  [in]  UINT       nIndex,
  [out] IConnector **ppConnector
);

Parametri

[in] nIndex

Numero di connettore. Se una topologia del dispositivo contiene n connettori, i connettori vengono numerati da 0 a n - 1. Per ottenere il numero di connettori nella topologia del dispositivo, chiamare il metodo IDeviceTopology::GetConnectorCount .

[out] ppConnector

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IConnector dell'oggetto connettore. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata GetConnector ha esito negativo, *ppConnector è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito Descrizione
E_INVALIDARG
Il parametro nIndex non è compreso nell'intervallo.
E_POINTER
Puntatore ppConnector è NULL.

Commenti

Per esempi di codice che chiamano il metodo GetConnector , vedere le implementazioni delle funzioni GetHardwareDeviceTopology e SelectCaptureDevice in Topologie di dispositivo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IConnector

Interfaccia IDeviceTopology

IDeviceTopology::GetConnectorCount