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