Metodo IConnector::GetConnectedTo (devicetopology.h)

  • Articolo

Il metodo GetConnectedTo ottiene il connettore a cui è connesso questo connettore.

Sintassi

HRESULT GetConnectedTo(
  [out] IConnector **ppConTo
);

Parametri

[out] ppConTo

Puntatore a una variabile del puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IConnector dell'altro 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 GetConnectedTo ha esito negativo, *ppConTo è NULL.

Valore restituito

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

Codice restituito Descrizione
E_POINTER
 Puntatore ppConTo è NULL.
E_NOTFOUND
 Questo connettore non è connesso o l'altro lato della connessione non è un'altra topologia del dispositivo, ad esempio una connessione Software_IO.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
 La topologia del dispositivo dall'altra parte della connessione non è attiva, ovvero lo stato del dispositivo non è DEVICE_STATE_ACTIVE.

Commenti

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

Per informazioni sulle connessioni Software_IO, vedere Enumerazione ConnectorType. Per informazioni sulla macro HRESULT_FROM_WIN32, vedere la documentazione di Windows SDK. Per informazioni sullo stato del dispositivo DEVICE_STATE_NOTPRESENT, vedere costanti DEVICE_STATE_XXX.

Requisiti

   
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