KSPROPERTY_TUNER_SCAN_STATUS
KSPROPERTY_TUNER_SCAN_STATUS 属性描述扫描操作的状态。 可以选择性地实现此属性。
使用情况摘要表
Get | Set | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 |
否 |
Pin |
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) |
另请参阅
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S