Método IDeviceTopology::GetConnector (devicetopology.h)

O método GetConnector obtém o conector especificado por um número do conector.

Sintaxe

HRESULT GetConnector(
  [in]  UINT       nIndex,
  [out] IConnector **ppConnector
);

Parâmetros

[in] nIndex

O número do conector. Se uma topologia de dispositivo contiver n conectores, os conectores serão numerados de 0 a n – 1. Para obter o número de conectores na topologia do dispositivo, chame o método IDeviceTopology::GetConnectorCount .

[out] ppConnector

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IConnector do objeto do 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 GetConnector falhar, *ppConnector será NULL.

Retornar valor

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_INVALIDARG	O parâmetro nIndex está fora do intervalo.
E_POINTER	O ponteiro ppConnector é NULL.

Comentários

Para obter exemplos de código que chamam o método GetConnector , consulte as implementações das funções GetHardwareDeviceTopology e SelectCaptureDevice em Topologias de Dispositivo.

Requisitos

Requisito	Valor
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

IDeviceTopology Interface

IDeviceTopology::GetConnectorCount