IDeviceTopology 接口 (devicetopology.h)

IDeviceTopology 接口提供对音频设备拓扑的访问。 音频 适配器 设备的拓扑由通往音频终结点设备的数据路径以及沿路径的控制点组成。 音频 终结点 设备也有一个拓扑,但它是微不足道的,如 设备拓扑中所述。 客户端通过执行以下步骤获取对音频终结点设备的 IDeviceTopology 接口的引用:

  1. 通过使用 IMMDevice 接口中所述的技术之一,获取对音频终结点设备的 IMMDevice 接口的引用。
  2. 调用参数 refiid 设置为 REFIIDIMMDevice::Activate 方法IID_IDeviceTopology。
获取音频终结点设备的 IDeviceTopology 接口后,应用程序可以浏览终结点设备连接到的音频适配器设备的拓扑。

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

继承

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

方法

IDeviceTopology 接口具有这些方法。

 
IDeviceTopology::GetConnector

GetConnector 方法获取由连接器编号指定的连接器。
IDeviceTopology::GetConnectorCount

GetConnectorCount 方法获取设备拓扑对象中的连接器数。
IDeviceTopology::GetDeviceId

GetDeviceId 方法获取设备拓扑对象表示的设备的设备标识符。
IDeviceTopology::GetPartById

GetPartById 方法获取由其本地 ID 标识的部件。
IDeviceTopology::GetSignalPath

GetSignalPath 方法获取信号路径中链接两个部分(如果该路径存在)的部件列表。
IDeviceTopology::GetSubunit

GetSubunit 方法获取由子单位编号指定的子单位。
IDeviceTopology::GetSubunitCount

GetSubunitCount 方法获取设备拓扑中的子单元数。

要求

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

另请参阅

核心音频接口

DeviceTopology API

IMMDevice::Activate