KSPROPERTY_TUNER_SCAN_STATUS

KSPROPERTY_TUNER_SCAN_STATUS 属性描述扫描操作的状态。 可以选择性地实现此属性。

使用情况摘要表

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

Pin

KSPROPERTY_TUNER_SCAN_STATUS_S

KSPROPERTY_TUNER_SCAN_STATUS_S

属性值 (操作数据) 是一个指定扫描操作状态的KSPROPERTY_TUNER_SCAN_STATUS_S结构。

注解

KsTvTune.ax 模块可以随时调用驱动程序的 KSPROPERTY_TUNER_SCAN_STATUS 属性。 但是, KsTvTune.ax 通常在调用 KSEVENT_TUNER_INITIATE_SCAN 事件后调用 KSPROPERTY_TUNER_SCAN_STATUS ,以设置扫描操作并设置扫描完成时间的通知。 然后,KsTvTune.ax 等待扫描完成通知出现。 作为最坏的情况,KsTvTune.ax 等待TUNER_ANALOG_CAPS_S结构的 SettlingTime 成员中指定的时间量。 驱动程序应已从调用其 KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS 属性返回填充的 TUNER_ANALOG_CAPS_S ,并在 KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S 结构的 NetworkType 成员中设置 ANALOG_TV_NETWORK_TYPE 值。 但是,调谐器通常应该比 SettlingTime 中指定的时间更快地确定信号的状态,然后应该通过向事件发出信号来通知 KsTvTune.ax 扫描已完成。

仅当优化设备支持硬件辅助扫描时,驱动程序才会返回扫描状态。 驱动程序通过在调用KSPROPERTY_TUNER_SCAN_CAPS属性时将 KSPROPERTY_TUNER_SCAN_CAPS_S 结构的 fSupportsHardwareAssistedScanning 成员设置为 TRUE 来指示此类支持。 驱动程序应发出事件信号,并在 KSPROPERTY_TUNER_SCAN_STATUS_S 结构的 LockStatus 成员中返回以下锁类型之一:

  • 如果 优化设备根本找不到任何信号,Tuner_LockType_None。

  • Tuner_LockType_Locked 优化设备是否锁定在确切的频率上。

要求

版本

在 Windows Vista 和更高版本的操作系统中可用。

标头

Ksmedia.h (包括 Ksmedia.h)

另请参阅

KSEVENT_TUNER_INITIATE_SCAN

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S

KSPROPERTY_TUNER_SCAN_CAPS

KSPROPERTY_TUNER_SCAN_CAPS_S

KSPROPERTY_TUNER_SCAN_STATUS_S

TUNER_ANALOG_CAPS_S