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.

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

Confira também

IConnector Interface

IDeviceTopology Interface

IDeviceTopology::GetConnectorCount