iKsJackDescription2 接口 (devicetopology.h)

IKsJackDescription2 接口提供有关插孔或内部连接器的信息,这些插孔或内部连接器在音频适配器上的设备与外部或内部终结点设备之间提供物理连接 (例如麦克风或 CD 播放器) 。

除了获取连接类型等插孔信息外, IKsJackDescription 还主要用于报告插孔是否已连接到设备。 在 Windows 7 中,如果连接的设备驱动程序支持 IKsJackDescription2,则音频堆栈或应用程序可以使用此接口获取其他插孔信息。 这包括插孔的检测功能,以及设备的格式是否已动态更改。

大多数 Windows 音频适配器驱动程序支持 Windows 驱动程序模型 (WDM) ,并使用内核流式处理 (KS) 属性来表示连接器中的硬件说明参数, (称为 KS 引脚) 。 IKsJackDescription2 接口提供对终结点设备的连接器KSPROPERTY_JACK_DESCRIPTION2属性的便捷访问。 有关 KS 属性和 KS 引脚的详细信息,请参阅 Windows DDK 文档。

应用程序通过调用 IPart::Activate 方法获取对部件的 IKsJackDescription2 接口的引用,并将参数 refiid 设置为 REFIIDIID_IKsJackDescription2。 仅当部件支持 IKsJackDescription2 接口时,对 IPart::Activate 的调用才会成功。 只有表示 KS 筛选器设备拓扑对象上的网桥引脚连接器的部件对象支持此接口。

有关代码示例,请参阅 IKsJackDescription

继承

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

方法

IKsJackDescription2 接口包含以下方法。

 
IKsJackDescription2::GetJackCount

GetJackCount 方法获取连接器上连接到终结点设备所需的插孔数。
IKsJackDescription2::GetJackDescription2

GetJackDescription2 方法获取指定音频插孔的说明。

要求

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

另请参阅

核心音频接口

DeviceTopology API

IPart::Activate