iConnector 接口 (devicetopology.h)

IConnector 接口表示组件之间的连接点。 客户端通过调用 IDeviceTopology::GetConnector 或 IConnector::GetConnectedTo 方法或调用 IPart::QueryInterface 方法(参数 iid 设置为 REFIID IID_IConnector)来获取对 IConnector 接口的引用。

IConnector 接口实例可以表示:

  • 硬件上的音频插孔
  • 例如,与集成终结点设备的内部连接 (笔记本电脑中的内置麦克风)
  • 通过 DMA 传输实现的软件连接
IConnector 接口中的方法可以描述各种类型的连接器。 连接器的类型 (ConnectorType 枚举常量) ,子类型 (从 IPart::GetSubType 方法) 获取的 GUID。

设备拓扑中的部件可以是连接器或子单元。 IPart 接口提供连接器和子单元通用的方法。

有关使用 IConnector 接口的代码示例,请参阅 设备拓扑中 GetHardwareDeviceTopology 和 SelectCaptureDevice 函数的实现。

继承

IConnector 接口继承自 IUnknown 接口。 IConnector 还具有以下类型的成员:

方法

IConnector 接口具有这些方法。

 
IConnector::ConnectTo

ConnectTo 方法将此连接器连接到另一个设备拓扑对象中的连接器。
IConnector::D isconnect

Disconnect 方法将此连接器与另一个连接器断开连接。
IConnector::GetConnectedTo

GetConnectedTo 方法获取此连接器连接到的连接器。
IConnector::GetConnectorIdConnectedTo

GetConnectorIdConnectedTo 方法获取此连接器连接到的连接器的全局 ID(如果有)。
IConnector::GetDataFlow

GetDataFlow 方法获取通过此连接器的数据流方向。
IConnector::GetDeviceIdConnectedTo

GetDeviceIdConnectedTo 方法获取此连接器连接到的音频设备的设备标识符(如果有)。
IConnector::GetType

GetType 方法获取此连接器的类型。
IConnector::IsConnected

IsConnected 方法指示此连接器是否连接到另一个连接器。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

核心音频接口

DeviceTopology API

IConnector::GetConnectedTo

IDeviceTopology::GetConnector