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

  • Artigo

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
E_POINTER
 O ponteiro ppConTo é NULL.
E_NOTFOUND
 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).
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
 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

Confira também

IConnector Interface