KSPROPERTY_PIN_PROPOSEDATAFORMAT
客户端使用 KSPROPERTY_PIN_PROPOSEDATAFORMAT 属性来确定由引脚工厂实例化的引脚是否支持特定的数据格式。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
| 是 | 是 | 筛选器 | KSP_PIN | KSDATAFORMAT |
注解
KSPROPERTY_PIN_PROPOSEDATAFORMAT 包括 KSDATAFORMAT 类型的结构，用于指定建议的数据格式。 使用 KSP_PIN 指定此属性，其中 成员指定相关的引脚工厂。
将 KSPROPERTY_TYPE_GET 与此属性配合使用，音频驱动程序可以提供有关引脚上默认数据格式的信息。 KSPROPERTY_TYPE_GET是可选的，可针对此属性实现，除非驱动程序支持 KSEVENT_PINCAPS_FORMATCHANGE。
如果将引脚设置为 或使用建议的数据格式打开，则 KS 筛选器在将此属性与 KSPROPERTY_TYPE_SET 时返回STATUS_SUCCESS。 如果引脚无法设置为建议的数据格式，则返回STATUS_NO_MATCH。 对于任何其他故障，将返回相应的错误。 如果驱动程序支持 KSPROPERTY_AUDIOSIGNALPROCESSING_MODES，则如果任何音频信号处理模式支持该格式，则此属性应返回STATUS_SUCCESS。
对此属性使用 KSPROPERTY_TYPE_SET实际上不会更改数据格式。 客户端使用 KSPROPERTY_CONNECTION_DATAFORMAT 更改数据格式。 对于此属性，KSPROPERTY_TYPE_SET是可选的。
要求
标头： ks.h (包括 Ks.h)