KSPROPERTY_TUNER_SCAN_STATUS

项目
02/07/2024

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 成员中返回以下锁类型之一：