iKsFormatSupport 接口 (devicetopology.h)
IKsFormatSupport 接口提供有关软件配置的 I/O 连接支持的音频数据格式的信息, (通常是音频适配器设备和系统内存之间的 DMA 通道) 。 客户端通过调用 IPart::Activate 方法获取对部件的 IKsFormatSupport 接口的引用,并将参数 refiid 设置为 REFIID IID_IKsFormatSupport。 仅当部件支持 IKsFormatSupport 接口时,对 IPart::Activate 的调用才会成功。 只有表示具有Software_IO连接类型的连接器的部件对象才支持此接口。 有关Software_IO的详细信息,请参阅 ConnectorType 枚举。
大多数 Windows 音频适配器驱动程序支持 Windows 驱动程序模型 (WDM) ,并使用内核流式处理 (KS) 属性来表示连接器中的硬件说明参数 (称为 KS 引脚) 。 IKsFormatSupport 接口提供对系统总线的连接器KSPROPERTY_PIN_DATAINTERSECTION和KSPROPERTY_PIN_PROPOSEDDATAFORMAT属性的便捷访问,通常 (PCI 或 PCI Express) 或外部总线 (例如 USB) 。 并非所有驱动程序都支持 KSPROPERTY_PIN_PROPOSEDDATAFORMAT 属性。 如果驱动程序不支持此属性, IKsFormatSupport 将使用连接器的 KS 数据范围中的信息来确定连接器是否支持建议的格式。 有关 KS 属性、KS 引脚和 KS 数据范围的详细信息,请参阅 Windows DDK 文档。
继承
IKsFormatSupport 接口继承自 IUnknown 接口。 IKsFormatSupport 还具有以下类型的成员:
方法
IKsFormatSupport 接口具有这些方法。
IKsFormatSupport::GetDevicePreferredFormat GetDevicePreferredFormat 方法获取连接的首选音频流格式。 |
IKsFormatSupport::IsFormatSupported IsFormatSupported 方法指示音频终结点设备是否支持指定的音频流格式。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | devicetopology.h |