KSPROPERTY_TUNER_SCAN_STATUS

Artículo
02/07/2024

La propiedad KSPROPERTY_TUNER_SCAN_STATUS describe el estado de una operación de examen. Esta propiedad se puede implementar opcionalmente.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	No	Anclar	KSPROPERTY_TUNER_SCAN_STATUS_S	KSPROPERTY_TUNER_SCAN_STATUS_S

El valor de propiedad (datos de operación) es una estructura KSPROPERTY_TUNER_SCAN_STATUS_S que especifica el estado de una operación de examen.

Comentarios

El módulo KsTvTune.ax puede llamar a la propiedad KSPROPERTY_TUNER_SCAN_STATUS del controlador en cualquier momento. Sin embargo, KsTvTune.ax normalmente llama a KSPROPERTY_TUNER_SCAN_STATUS después de llamar al evento KSEVENT_TUNER_INITIATE_SCAN para configurar una operación de examen y para configurar la notificación cuando se completa el examen. KsTvTune.ax espera a que se produzca la notificación de finalización del examen. Como peor escenario, KsTvTune.ax espera la cantidad de tiempo que se especifica en el miembro SettlingTime de la estructura TUNER_ANALOG_CAPS_S . El controlador debe haber devuelto un TUNER_ANALOG_CAPS_S rellenado desde una llamada a su propiedad KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS con el valor ANALOG_TV_NETWORK_TYPE establecido en el miembro NetworkType de la estructura KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S . Sin embargo, el sintonizador normalmente debe determinar el estado de la señal más rápido que la cantidad de tiempo que se especifica en SettlingTime y, a continuación, debe notificar a KsTvTune.ax que el examen se completó mediante la señalización del evento.

El controlador devuelve el estado del examen solo si el dispositivo de optimización admite el examen asistido por hardware. El controlador indica dicha compatibilidad estableciendo el miembro fSupportsHardwareAssistedScanning de la estructura de KSPROPERTY_TUNER_SCAN_CAPS_S en TRUE en una llamada a su propiedad KSPROPERTY_TUNER_SCAN_CAPS . El controlador debe indicar un evento y devolver uno de los siguientes tipos de bloqueo en el miembro LockStatus de la estructura KSPROPERTY_TUNER_SCAN_STATUS_S :

Tuner_LockType_None si el dispositivo de ajuste no pudo encontrar ninguna señal.
Tuner_LockType_Locked si el dispositivo de ajuste está bloqueado en la frecuencia exacta.