TUNER_ANALOG_CAPS_S結構（ksmedia.h）

發行項
02/07/2025

TUNER_ANALOG_CAPS_S 結構描述支援模擬廣播網路之微調裝置的硬體掃描功能。

語法

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;

成員

Mode

目前的微調器模式，可從 Ksmedia.h 中定義的KSPROPERTY_TUNER_MODES列舉，由下列其中一個微調模式旗標表示。

旗	意義
KSPROPERTY_TUNER_MODE_TV	調音器目前正在微調廣播或有線電視頻道。
KSPROPERTY_TUNER_MODE_FM_RADIO	微調器目前正在微調 FM 無線電信道。
KSPROPERTY_TUNER_MODE_AM_RADIO	微調器目前正在微調AM無線電信道。
KSPROPERTY_TUNER_MODE_DSS	微調器目前正在微調 DSS 通道。
KSPROPERTY_TUNER_MODE_ATSC	調音器能夠調整高級電視系統委員會廣播（美國數字電視）。 DVB-T 和 DVB-C 系統也可以使用此設定。

StandardsSupported

如果模式成員設定為KSPROPERTY_TUNER_MODE_TV或KSPROPERTY_TUNER_MODE_DSS，則來自 KS_AnalogVideoStandard 列舉的位 OR 值，表示微調器支援的模擬視訊標準。否則會忽略此成員。

MinFrequency

微調器支援的最低頻率，以 Hz 為單位。

MaxFrequency

微調器支援的最高頻率，以 Hz 為單位。

TuningGranularity

最小可能的步驟大小，以 Hz 為單位，介於微調頻率的兩個設定之間。

SettlingTime

時間，以毫秒為單位，讓新的頻率設定變得穩定。

KsTvTune.ax 會使用 SettlingTime 中的值來評估掃描演算法可能需要的總時間，以便判斷等候時間。 Settling Time 中的值，以及以感應範圍為基礎的整個頻率範圍中的逐步遞增數目，應該提供掃描演算法所需總時間的估計值。

ScanSensingRange

微調裝置提供的範圍，以及微調器篩選條件用來判斷訊號是否存在。此範圍代表訊號搜尋演算法可用來前進到搜尋頻率範圍的較大步驟大小。驅動程式可以透過呼叫驅動程式的 KSPROPERTY_TUNER_SCAN_STATUS 屬性，報告訊號的實際鎖定頻率和訊號上的鎖定狀態。如果驅動程式在 LockStatusKSPROPERTY_TUNER_SCAN_STATUS_S 結構的成員中將鎖定狀態回報為Tuner_LockType_Within_Scan_Sensing_Range，則遞增步驟大小會變更為 FineTuneSensingRange 中較小的值，直到決定實際鎖定頻率為止。

FineTuneSensingRange

微調裝置提供的範圍，以及微調器篩選條件用來判斷訊號的實際頻率。只有在基礎微調器硬體無法支援硬體輔助掃描時，微調篩選器才會使用此微調感知範圍。驅動程式會設定 fSupportsHardwareAssistedScanningKSPROPERTY_TUNER_SCAN_CAPS_S 結構成員，以在呼叫其 KSPROPERTY_TUNER_SCAN_CAPS 屬性時 TRUE，以指出這類支援。當微調器篩選開始掃描時，它會在 ScanSensingRange 成員指定的範圍內，以遞增方式探查驅動程式，直到驅動程式傳回Tuner_LockType_Within_Scan_Sensing_Range為止。微調器篩選器接著會切換至 FineTuneSensingRange 的步驟，直到驅動程式回報完整的鎖定為止。