KSPROPERTY_PIN_PROPOSEDATAFORMAT

项目
06/15/2023

客户端使用 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是可选的。