TUNER_ANALOG_CAPS_S struttura (ksmedia.h)

Articolo
02/29/2024

La struttura TUNER_ANALOG_CAPS_S descrive le funzionalità di analisi hardware di un dispositivo di ottimizzazione che supporta una rete di trasmissione analogica.

Sintassi

typedef struct {
  ULONG Mode;
  ULONG StandardsSupported;
  ULONG MinFrequency;
  ULONG MaxFrequency;
  ULONG TuningGranularity;
  ULONG SettlingTime;
  ULONG ScanSensingRange;
  ULONG FineTuneSensingRange;
} TUNER_ANALOG_CAPS_S, *PTUNER_ANALOG_CAPS_S;

Members

Mode

La modalità di tuner corrente, che può essere rappresentata da uno dei flag di modalità tuner seguenti dall'enumerazione KSPROPERTY_TUNER_MODES definita in Ksmedia.h.

Contrassegno	Significato
KSPROPERTY_TUNER_MODE_TV	Il tuner è attualmente in fase di ottimizzazione dei canali televisivi o di trasmissione via cavo.
KSPROPERTY_TUNER_MODE_FM_RADIO	Il tuner sta attualmente ottimizzando i canali radio FM.
KSPROPERTY_TUNER_MODE_AM_RADIO	Il tuner sta attualmente ottimizzando i canali radio AM.
KSPROPERTY_TUNER_MODE_DSS	Il tuner sta attualmente ottimizzando i canali DSS.
KSPROPERTY_TUNER_MODE_ATSC	Il tuner è in grado di ottimizzare le trasmissioni avanzate del sistema televisivo (TV digitale per il Stati Uniti). Questa impostazione può essere usata anche dai sistemi UNIX-T e DVB-C.

StandardsSupported

Se il membro Mode è impostato su KSPROPERTY_TUNER_MODE_TV o KSPROPERTY_TUNER_MODE_DSS, un or bit per bit dei valori dell'enumerazione KS_AnalogVideoStandard che indica gli standard video analogici supportati dal tuner. In caso contrario, questo membro viene ignorato.

MinFrequency

La frequenza più bassa, in Hz, supportata dal tuner.

MaxFrequency

La frequenza più alta, in Hz, supportata dal tuner.

TuningGranularity

Dimensioni più piccole possibili, in Hz, tra due impostazioni della frequenza di ottimizzazione.

SettlingTime

Il tempo, in millisecondi, per un'impostazione di nuova frequenza di diventare stabile.

KsTvTune.ax usa il valore in SettlingTime per valutare il tempo totale che potrebbe richiedere l'algoritmo di analisi in modo che possa determinare il tempo di attesa. Il valore in SettlingTime insieme al numero di incrementi di passaggi nell'intero intervallo di frequenza basato sull'intervallo di rilevamento deve fornire una stima del tempo totale necessario per l'algoritmo di analisi.

ScanSensingRange

Intervallo fornito dal dispositivo di ottimizzazione e utilizzato dal filtro del tuner per determinare la presenza di un segnale. Questo intervallo rappresenta le dimensioni più grandi che un algoritmo di ricerca segnale può usare per passare attraverso l'intervallo di frequenze da cercare. Il driver può segnalare la frequenza effettiva di blocco di un segnale e lo stato di blocco sul segnale tramite una chiamata alla proprietà KSPROPERTY_TUNER_SCAN_STATUS del driver. Se il driver segnala lo stato di blocco come Tuner_LockType_Within_Scan_Sensing_Range nel membro LockStatus della struttura KSPROPERTY_TUNER_SCAN_STATUS_S , le dimensioni del passaggio di incremento cambiano nel valore più piccolo in FineTuneSensingRange finché non viene determinata la frequenza effettiva di blocco.

FineTuneSensingRange

Intervallo fornito dal dispositivo di ottimizzazione e utilizzato dal filtro del tuner per determinare la frequenza effettiva di un segnale. Il filtro del tuner usa questo intervallo di rilevamento ottimizzato solo quando l'hardware del tuner sottostante non può supportare l'analisi assistita dall'hardware. Il driver indica tale supporto impostando il membro fSupportsHardwareAssistedScanning della struttura KSPROPERTY_TUNER_SCAN_CAPS_S su TRUE in una chiamata alla relativa proprietà KSPROPERTY_TUNER_SCAN_CAPS . Quando il filtro del tuner avvia un'analisi, esegue inizialmente il probe del driver in incrementi all'interno dell'intervallo specificato dal membro ScanSensingRange fino a quando il driver non restituisce Tuner_LockType_Within_Scan_Sensing_Range. Il filtro del tuner passa quindi a passaggi di FineTuneSensingRange fino a quando il driver segnala un blocco completo.