Interfaccia IConnector (devicetopology.h)

L'interfaccia IConnector rappresenta un punto di connessione tra i componenti. Il client ottiene un riferimento a un'interfaccia IConnector chiamando il metodo IDeviceTopology::GetConnector o IConnector::GetConnectedTo oppure chiamando il metodo IPart::QueryInterface con parametro iid impostato su REFIID IID_IConnector.

Un'istanza dell'interfaccia IConnector può rappresentare:

  • Jack audio su un pezzo di hardware
  • Connessione interna a un dispositivo endpoint integrato ,ad esempio un microfono predefinito in un computer portatile)
  • Connessione software implementata tramite trasferimenti DMA
I metodi nell'interfaccia IConnector possono descrivere vari tipi di connettori. Un connettore ha un tipo (costante di enumerazione ConnectorType ) e un sottotipo (un GUID ottenuto dal metodo IPart::GetSubType ).

Una parte in una topologia del dispositivo può essere un connettore o una subunit. L'interfaccia IPart fornisce metodi comuni ai connettori e alle sottounite.

Per esempi di codice che usano l'interfaccia IConnector , vedere le implementazioni delle funzioni GetHardwareDeviceTopology e SelectCaptureDevice in Topologie di dispositivo.

Ereditarietà

L'interfaccia IConnector eredita dall'interfaccia IUnknown . IConnector include anche questi tipi di membri:

Metodi

L'interfaccia IConnector include questi metodi.

 
IConnector::ConnectTo

Il metodo ConnectTo connette questo connettore a un connettore in un altro oggetto della topologia del dispositivo.
IConnector::D isconnect

Il metodo Disconnect disconnette questo connettore da un altro connettore.
IConnector::GetConnectedTo

Il metodo GetConnectedTo ottiene il connettore a cui è connesso questo connettore.
IConnector::GetConnectorIdConnectedTo

Il metodo GetConnectorIdConnectedTo ottiene l'ID globale del connettore, se presente, a cui è connesso questo connettore.
IConnector::GetDataFlow

Il metodo GetDataFlow ottiene la direzione del flusso di dati tramite questo connettore.
IConnector::GetDeviceIdConnectedTo

Il metodo GetDeviceIdConnectedTo ottiene l'identificatore del dispositivo audio, se presente, a cui è connesso questo connettore.
IConnector::GetType

Il metodo GetType ottiene il tipo di questo connettore.
IConnector::IsConnected

Il metodo IsConnected indica se questo connettore è connesso a un altro connettore.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfacce audio principali

DeviceTopology API

IConnector::GetConnectedTo

IDeviceTopology::GetConnector