KSPROPERTY_STREAM_RATE

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

使用情况摘要表

Get Set 目标 属性描述符类型 属性值类型

Pin

KSPROPERTY

KSRATE

注解

如果引脚允许速率更改,或者拓扑相关引脚之间的接口不同并导致使用不同的时间戳格式,则应实现KSPROPERTY_STREAM_RATE。

属性受引脚支持,这些引脚可以通过重新采样或时间戳更改来修改数据速率,以便请求的速率可以更接近 1.0 的名义速率。

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

速率设置和查询都使用 KSRATE 结构,该结构指定演示开始时间、持续时间和速率。 速率更改只能在暂停或运行状态下执行,在更改为任何其他状态后停止。 速率更改由引脚要调整的 1.0 速率上或低于名义 1.0 速率的百分比指定,并且以相同的格式返回当前设置。

此属性还应该用于转换上一属性中指定的接口和时间单位,并且应在更改引脚之间的接口的筛选器上实现,即使不支持速率更改。 例如,在一个引脚上支持KSINTERFACE_STANDARD_POSITION并转换为拓扑相关另一个引脚上的KSINTERFACE_STANDARD_STREAMING的筛选器可能不支持速率更改。 筛选器应能够在任一引脚和任一接口上接受更改请求,并更改为自己的接口和单位,但速率将保持不变。

如果引脚还生成了时钟,则速率更改不得更改物理时间的斜率,因为任何使用该时钟进行速率匹配的客户端都期望斜率与基础硬件以名义 1.0 速率运行一样。 这意味着无法确保物理时钟斜率保持一致且没有明显偏移的引脚无法接受速率调整请求。

要求

标头

Ks.h (包括 Ks.h)

另请参阅

KSPROPERTY_STREAM_RATECAPABILITY

KSRATE