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 中的值来评估扫描算法可能需要的总时间，以便确定等待时间。 SettlingTime 的值以及基于感应范围的整个频率范围内的单步递增数应提供扫描算法所需的总时间的估计值。

ScanSensingRange

优化设备提供的范围以及优化器筛选器用于确定信号是否存在。此范围表示信号搜索算法可用于在要搜索的频率范围内前进的更大步骤大小。驱动程序可以通过调用驱动程序的 KSPROPERTY_TUNER_SCAN_STATUS 属性报告信号的实际锁定频率和信号上的锁定状态。如果驱动程序将锁定状态报告为 LockStatusKSPROPERTY_TUNER_SCAN_STATUS_S 结构的成员中的Tuner_LockType_Within_Scan_Sensing_Range，则增量步长大小将更改为 FineTuneSensingRange 中的较小值，直到确定实际锁定频率为止。

FineTuneSensingRange

优化设备提供的范围以及优化器筛选器用于确定信号的实际频率。仅当基础优化器硬件不支持硬件辅助扫描时，优化器筛选器才使用此微调感知范围。驱动程序通过将 KSPROPERTY_TUNER_SCAN_CAPS_S 结构的 fSupportsHardwareAssistedScanning 成员设置为在其 KSPROPERTY_TUNER_SCAN_CAPS 属性的调用中 TRUE 来指示此类支持。当优化器筛选器启动扫描时，它会在 ScanSensingRange 成员指定的范围内以增量探测驱动程序，直到驱动程序返回Tuner_LockType_Within_Scan_Sensing_Range为止。然后，优化器筛选器切换到 FineTuneSensingRange 的步骤，直到驱动程序报告完整的锁。