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

另请参阅

核心音频接口

DeviceTopology API

IPart：：Activate