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 обычно вызывает KSPROPERTY_TUNER_SCAN_STATUS после вызова события KSEVENT_TUNER_INITIATE_SCAN , чтобы настроить операцию сканирования и настроить уведомление о завершении сканирования. KsTvTune.ax затем ожидает уведомления о завершении сканирования. В худшем случае KsTvTune.ax ожидает времени, указанного в элементе SettlingTime структуры TUNER_ANALOG_CAPS_S . Драйвер должен был вернуть заполненное TUNER_ANALOG_CAPS_S из вызова своего свойства KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS со значением ANALOG_TV_NETWORK_TYPE, заданным в элементе NetworkType структуры KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S . Однако тюнер обычно должен определять состояние сигнала быстрее, чем время, указанное в SettlingTime , а затем уведомлять KsTvTune.ax о том, что сканирование завершено путем передачи сигнала о событии.
Драйвер возвращает состояние сканирования, только если устройство настройки поддерживает аппаратное сканирование. Драйвер указывает на такую поддержку, задав члену fSupportsHardwareAssistedScanning структуры KSPROPERTY_TUNER_SCAN_CAPS_Sзначение TRUE в вызове его свойства KSPROPERTY_TUNER_SCAN_CAPS . Драйвер должен сообщить о событии и вернуть один из следующих типов блокировки в элементе LockStatusструктуры KSPROPERTY_TUNER_SCAN_STATUS_S :
Tuner_LockType_None , если устройство настройки не может найти какой-либо сигнал.
Tuner_LockType_Locked , если устройство настройки заблокировало точную частоту.
Требования
Версия |
Доступно в Windows Vista и более поздних версиях операционной системы. |
Заголовок |
Ksmedia.h (включая Ksmedia.h) |
См. также раздел
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S