KSPROPERTY_STREAM_RATE

KSPROPERTY_STREAM_RATE 属性与 KSPROPERTY_STREAM_RATECAPABILITY 结合使用,用于在查询 pin 功能后设置段的速率。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型

Pin

KSPROPERTY

KSRATE

备注

如果 pin 允许速率改变,或者界定闭合相关 pin 之间的接口不同,并使用不同的时间戳格式,则应该实现 KSPROPERTY_STREAM_RATE。

此属性由 pin 支持,可以通过重新采样或时间戳更改来修改数据的速率,以使请求的速率更接近标称速率1.0。

读取属性将返回当前速率和段。 设置新段的速率将替换任何当前速率设置。 通过这种方式,可以通过请求1.0 的费率设置来停止快进请求,该设置应始终接受。 如果无法获得指定的速率,则 pin 可以拒绝请求,而不是尝试最佳设置。

Rate 设置和查询都使用 KSRATE 结构来指定演示开始、持续时间和速度。 只能在 "暂停" 或 "运行" 状态中执行速率更改,并在更改为任何其他状态后停止。 速率更改是根据 pin 要调整的1.0 标称百分比或下的百分比指定的,当前设置以相同的格式返回。

此属性还应用于转换在上一个属性中指定的接口和时间单位,并且应在更改 pin 之间的接口的筛选器上实现,即使不支持速率更改也是如此。 例如,支持在一个插针上 KSINTERFACE_STANDARD_POSITION 的筛选器在拓扑相关的其他 pin 上转换为 KSINTERFACE_STANDARD_STREAMING 可能不支持速率更改。 筛选器应该能够在任一 pin 上执行更改请求,并可以对其自己的接口和单位进行更改,但是速度会保持不变。

如果 pin 还生成时钟,则速率更改不能更改物理时间的斜率,因为使用时钟进行速率匹配的任何客户端都需要使用时钟进行速率匹配的客户端,就像以名义1.0 费率运行基础硬件一样。 这意味着,无法确保物理时钟斜度保持一致,且不会产生严重偏差的 pin 无法接受速率调整请求。

要求

标头

Ks (包含 Ks .h)

另请参阅

KSPROPERTY_STREAM_RATECAPABILITY

KSRATE