Método IConnector::GetConnectedTo (devicetopology.h)
O método GetConnectedTo obtém o conector ao qual esse conector está conectado.
Sintaxe
HRESULT GetConnectedTo(
[out] IConnector **ppConTo
);
Parâmetros
[out] ppConTo
Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IConnector do outro objeto conector. Por meio desse método, o chamador obtém uma referência contada à interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada GetConnectedTo falhar, *ppConTo será NULL.
Valor retornado
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O ponteiro ppConTo é NULL. |
|
Esse conector não está conectado ou o outro lado da conexão não é outra topologia de dispositivo (por exemplo, uma conexão Software_IO). |
|
A topologia do dispositivo do outro lado da conexão não está ativa (ou seja, o estado do dispositivo não é DEVICE_STATE_ACTIVE). |
Comentários
Para obter exemplos de código que chamam esse método, consulte as implementações das funções GetHardwareDeviceTopology e SelectCaptureDevice em Topologias de Dispositivo.
Para obter informações sobre conexões Software_IO, consulte Enumeração ConnectorType. Para obter informações sobre a macro HRESULT_FROM_WIN32, consulte a documentação do SDK do Windows. Para obter informações sobre o estado do dispositivo DEVICE_STATE_NOTPRESENT, consulte Constantes de DEVICE_STATE_XXX.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | devicetopology.h |