estructura KSPROPERTY_TUNER_STATUS_S (ksmedia.h)

Artículo
02/29/2024

La estructura de KSPROPERTY_TUNER_STATUS_S describe el progreso de una operación de ajuste para los dispositivos de tv y de sintonizador de radio, incluida la frecuencia de ajuste actual.

Sintaxis

typedef struct {
  KSPROPERTY Property;
  ULONG      CurrentFrequency;
  ULONG      PLLOffset;
  ULONG      SignalStrength;
  ULONG      Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;

Miembros

Property

Especifica una estructura KSPROPERTY inicializada que describe el conjunto de propiedades, el identificador de propiedad y el tipo de solicitud.

CurrentFrequency

Especifica la frecuencia de tuerner actual. Este valor está en hercios (Hz).

PLLOffset

Especifica el desplazamiento del bucle bloqueado por fases (PLL) en múltiplo de la granularidad de optimización. Esto se usa si la estrategia de tuerca está KS_TUNER_STRATEGY_PLL. Si la estrategia de tuerca no es KS_TUNER_STRATEGY_PLL, este valor no tiene ningún significado. En la tabla siguiente se muestra el valor que devuelve el minidriver para diversas condiciones de ajuste, suponiendo que la granularidad de ajuste es de 62,5 kHz:

Desplazamiento de frecuencia	PLLOffset
+125,000	+2
+62,500	+1
Perfectamente ajustado	0
-62,500	-1
-125,000	-2

SignalStrength

Especifica la amplitud de la señal. Esto se usa si la estrategia de tuerca es KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Independientemente de la estrategia de optimización admitida por el minidriver, los valores válidos para este miembro son:

Valor	Significado
-1	Resistencia no disponible.
0	No en una frecuencia aceptable.
1	En una frecuencia aceptable.

Busy

Indica si el minidriver está ocupado actualmente con el proceso de ajuste. Este miembro debe establecerse en TRUE si el minidriver está ajustando actualmente a un canal. De lo contrario, si el minidriver no está ajustando actualmente a un nuevo canal, este miembro debe establecerse en FALSE.