Método IConnector::GetConnectedTo (devicetopology.h)
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 |
|---|---|
|
El puntero ppConTo es NULL. |
|
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). |
|
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 |