Interface IConnector (devicetopology.h)

A interface IConnector representa um ponto de conexão entre componentes. O cliente obtém uma referência a uma interface IConnector chamando o método IDeviceTopology::GetConnector ou IConnector::GetConnectedTo ou chamando o método IPart::QueryInterface com o parâmetro iid definido como REFIID IID_IConnector.

Uma instância de interface IConnector pode representar:

  • Uma tomada de áudio em um pedaço de hardware
  • Uma conexão interna com um dispositivo de ponto de extremidade integrado (por exemplo, um microfone interno em um computador laptop)
  • Uma conexão de software implementada por meio de transferências de DMA
Os métodos na interface IConnector podem descrever vários tipos de conectores. Um conector tem um tipo (uma constante de enumeração ConnectorType ) e um subtipo (um GUID obtido do método IPart::GetSubType ).

Uma parte em uma topologia de dispositivo pode ser um conector ou uma subunidade. A interface IPart fornece métodos comuns a conectores e subunidades.

Para obter exemplos de código que usam a interface IConnector , consulte as implementações das funções GetHardwareDeviceTopology e SelectCaptureDevice em Topologias de Dispositivo.

Herança

A interface IConnector herda da interface IUnknown . O IConnector também tem esses tipos de membros:

Métodos

A interface IConnector tem esses métodos.

 
IConnector::ConnectTo

O método ConnectTo conecta esse conector a um conector em outro objeto de topologia de dispositivo.
IConnector::D isconnect

O método Disconnect desconecta esse conector de outro conector.
IConnector::GetConnectedTo

O método GetConnectedTo obtém o conector ao qual esse conector está conectado.
IConnector::GetConnectorIdConnectedTo

O método GetConnectorIdConnectedTo obtém a ID global do conector, se houver, à qual esse conector está conectado.
IConnector::GetDataFlow

O método GetDataFlow obtém a direção do fluxo de dados por meio desse conector.
IConnector::GetDeviceIdConnectedTo

O método GetDeviceIdConnectedTo obtém o identificador de dispositivo do dispositivo de áudio, se houver, ao qual esse conector está conectado.
IConnector::GetType

O método GetType obtém o tipo desse conector.
IConnector::IsConnected

O método IsConnected indica se esse conector está conectado a outro conector.

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

Principais interfaces de áudio

DeviceTopology API

IConnector::GetConnectedTo

IDeviceTopology::GetConnector