Método IConnector::GetConnectedTo (devicetopology.h)

  • Artículo

El método GetConnectedTo obtiene el conector al que está conectado este conector.

Sintaxis

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

Parámetros

[out] ppConTo

Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz IConnector del otro objeto de conector. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a GetConnectedTo , *ppConTo es NULL.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 El puntero ppConTo es NULL.
E_NOTFOUND
 Este conector no está conectado o el otro lado de la conexión no es otra topología de dispositivo (por ejemplo, una conexión Software_IO).
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
 La topología del dispositivo en el otro lado de la conexión no está activa (es decir, el estado del dispositivo no es DEVICE_STATE_ACTIVE).

Comentarios

Para obtener ejemplos de código que llaman a este método, consulte las implementaciones de las funciones GetHardwareDeviceTopology y SelectCaptureDevice en Topologías de dispositivo.

Para obtener información sobre las conexiones de Software_IO, vea ConnectorType (enumeración). Para obtener información sobre la macro de HRESULT_FROM_WIN32, consulte la documentación de Windows SDK. Para obtener información sobre el estado del dispositivo DEVICE_STATE_NOTPRESENT, consulte DEVICE_STATE_XXX Constantes.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IConnector (Interfaz)