struttura KSPROPERTY_TUNER_STATUS_S (ksmedia.h)
La struttura KSPROPERTY_TUNER_STATUS_S descrive lo stato di avanzamento di un'operazione di ottimizzazione per i dispositivi TV e tuner radio, inclusa la frequenza di ottimizzazione attuale.
Sintassi
typedef struct {
KSPROPERTY Property;
ULONG CurrentFrequency;
ULONG PLLOffset;
ULONG SignalStrength;
ULONG Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;
Membri
Property
Specifica una struttura KSPROPERTY inizializzata che descrive il set di proprietà, l'ID proprietà e il tipo di richiesta.
CurrentFrequency
Specifica la frequenza corrente del tuner. Questo valore si trova inhz (Hz).
PLLOffset
Specifica l'offset PLL (Phase Locked Loop) in multipli della granularità di ottimizzazione. Questa operazione viene usata se la strategia di tuner è KS_TUNER_STRATEGY_PLL. Se la strategia di 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 di 62,5 kHz:
| Offset frequenza | PLLOffset |
|---|---|
| +125,000 | +2 |
| +62,500 | +1 |
| Perfettamente sintonizzato | 0 |
| -62,500 | -1 |
| -125,000 | -2 |
SignalStrength
Specifica l'ampiezza del segnale. Questa opzione 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 in base a una frequenza accettabile. |
| 1 | In base a 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 in fase di ottimizzazione su un nuovo canale, questo membro deve essere impostato su FALSE.
Osservazioni
Per altre informazioni sui PLLOffset e SignalStrength, vedere 'acquisizione tv basata su PCI. Se il dispositivo tuner supporta l'ottimizzazione radio, vedere Video Capture Devices with Radio Tuners.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ksmedia.h (include Ksmedia.h) |