KSPROPERTY_TUNER_STATUS_S struttura (ksmedia.h)
La struttura KSPROPERTY_TUNER_STATUS_S descrive lo stato di avanzamento di un'operazione di ottimizzazione per i dispositivi TV e radio tuner, inclusa la frequenza di ottimizzazione presente.
Sintassi
typedef struct {
KSPROPERTY Property;
ULONG CurrentFrequency;
ULONG PLLOffset;
ULONG SignalStrength;
ULONG Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;
Members
Property
Specifica una struttura KSPROPERTY inizializzata che descrive il set di proprietà, l'ID proprietà e il tipo di richiesta.
CurrentFrequency
Specifica la frequenza di tuner corrente. Questo valore è in hertz (Hz).
PLLOffset
Specifica l'offset PLL (Phase Locked Loop) in più della granularità di ottimizzazione. Questa operazione viene usata se la strategia di tuner è KS_TUNER_STRATEGY_PLL. Se la strategia del tuner non è KS_TUNER_STRATEGY_PLL, questo valore non ha alcun significato. La tabella seguente illustra il valore da restituire dal minidriver per varie condizioni di ottimizzazione, presupponendo che la granularità di ottimizzazione sia 62,5kHz:
| Offset di frequenza | PLLOffset |
|---|---|
| +125,000 | +2 |
| +62,500 | +1 |
| Perfettamente ottimizzato | 0 |
| -62,500 | -1 |
| -125,000 | -2 |
SignalStrength
Specifica l'ampiezza del segnale. Questa operazione viene usata se la strategia di tuner è KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Indipendentemente dalla strategia di ottimizzazione supportata dal minidriver, i valori validi per questo membro sono:
| Valore | Significato |
|---|---|
| -1 | Forza non disponibile. |
| 0 | Non su una frequenza accettabile. |
| 1 | In una frequenza accettabile. |
Busy
Indica se il minidriver è attualmente occupato con il processo di ottimizzazione. Questo membro deve essere impostato su TRUE se il minidriver sta attualmente ottimizzando un canale. In caso contrario, se il minidriver non è attualmente ottimizzazione per un nuovo canale, questo membro deve essere impostato su FALSE.
Commenti
Per altre informazioni sui membri PLLOffset e SignalStrength , vedere Acquisizione TV basata su PCI. Se il dispositivo di tuner supporta l'ottimizzazione radio, vedere Dispositivi di acquisizione video con Radio Tuner.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ksmedia.h (includere Ksmedia.h) |