KSPROPERTY_STREAM_PRESENTATIONTIME

KSPROPERTY_STREAM_PRESENTATIONTIME 属性用于检索和设置筛选器引脚的当前呈现时间。

使用情况摘要表

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

Pin

KSPROPERTY

KSTIME

注解

KSPROPERTY_STREAM_PRESENTATIONTIME是一个可选属性,如果引脚保留位置信息或在拓扑相关的引脚上使用具有不同时间戳格式的不同接口,则应实现该属性。 因此,需要将时间戳转换为查找演示时间。

筛选器引脚的呈现时间指定为 KSTIME 结构,其解释取决于所使用的接口。 对于标准流式处理接口,时间以 100 纳秒 (增量指定,除非分子和分母指定) 表示筛选器当前正在处理或正在尝试处理的流的表示位置。 如果这是呈现筛选器,则此位置表示当前正在呈现的数据。 此定位信息与主时钟的呈现时间同步。 呈现时间通常从零开始,可能表示文件数据的时间偏移量。 分子和分母可用于指定接口强制执行的块对齐方式。

在传播查找请求期间转换位置值时,也使用此属性。 一个引脚上的查找位置值在筛选器内转换为拓扑相关引脚上的呈现时间。 客户端使用新的流位置设置此属性以查找。 在取消未完成的 I/O 并重置设备状态后需要查找时,代理通常会调用此方法。 如果尚未执行重置,筛选器可能必须自动取消并相应地重置。 向 属性传递 KSTIME,其中包含新流位置(以与连接上使用的接口一致的单位)。

例如,在客户端 (之后,DirectShow 代理) 将查找请求写入一个连接,然后查询其他拓扑相关的连接,以等待演示时间。 执行成功读取请求的任何其他连接会使代理将结果位置传递到该连接的另一端。 通过这种方式,查找位置 (传播,例如,在整个 DirectShow 图) 传播,而无需知道客户端传递的初始单位格式以外的单位格式。 当位置信息在筛选器中的拓扑中传播时,在筛选器中发生转换。 之所以使用此环形交叉路口方法,是因为关系图中各种筛选器之间的通信方法可能会受到限制,具体取决于它们使用的接口。 设置新的寻道位置时,引脚必须接受分子/分母对。

要求

标头

Ks.h (包括 Ks.h)

另请参阅

KSTIME

KSPROPERTY