estructura KSPROPERTY_TUNER_STATUS_S (ksmedia.h)
La estructura KSPROPERTY_TUNER_STATUS_S describe el progreso de una operación de ajuste para los dispositivos de sintonizador de televisión y 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 de KSPROPERTY inicializada que describe el conjunto de propiedades, el identificador de propiedad y el tipo de solicitud.
CurrentFrequency
Especifica la frecuencia de tuner 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 tuner es 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 devuelto por el minidriver para varias 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 ajuste admitida por el minidriver, los valores válidos para este miembro son:
| Valor | Significado |
|---|---|
| -1 | Fuerza 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.
Observaciones
Para obtener más información sobre el PLLOffset y los miembros de SignalStrength ver captura de TV basada en PCI. Si el dispositivo de tuner admite el ajuste de radio, consulte Dispositivos de captura de vídeo con los sintonizadores de radio.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | ksmedia.h (incluya Ksmedia.h) |