KSPROPERTY_TUNER_STATUS_S 结构描述了电视和无线电优化器设备的优化作的进度,包括目前的优化频率。
语法
typedef struct {
KSPROPERTY Property;
ULONG CurrentFrequency;
ULONG PLLOffset;
ULONG SignalStrength;
ULONG Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;
成员
Property
指定描述属性集、属性 ID 和请求类型的初始化 KSPROPERTY 结构。
CurrentFrequency
指定当前优化器频率。 此值以赫茨为单位(Hz)。
PLLOffset
指定优化粒度的倍数中的相位锁定循环 (PLL) 偏移量。 如果优化器策略KS_TUNER_STRATEGY_PLL,则使用此策略。 如果未KS_TUNER_STRATEGY_PLL优化器策略,则此值没有意义。 下表演示了微型驱动程序针对各种优化条件返回的值,假设优化粒度为 62.5kHz:
频率偏移量 | PLLOffset |
---|---|
+125,000 | +2 |
+62,500 | +1 |
完美调整 | 0 |
-62,500 | -1 |
-125,000 | -2 |
SignalStrength
指定信号的振幅。 如果优化器策略KS_TUNER_STRATEGY_SIGNAL_STRENGTH,则使用此策略。 无论微型驱动程序支持的优化策略如何,此成员的有效值为:
价值 | 意义 |
---|---|
-1 | 强度不可用。 |
0 | 不按可接受的频率。 |
1 | 以可接受的频率。 |
Busy
指示微型驱动程序当前是否正忙于优化过程。 如果微型驱动程序当前正在优化到通道,则必须将此成员设置为 TRUE。 否则,如果微型驱动程序当前未优化到新通道,则必须将此成员设置为 FALSE。
言论
有关 PLLOffset 和 SignalStrength 成员的详细信息,请参阅 基于 PCI 的电视捕获。 如果优化器设备支持无线电优化,请参阅 带有无线电优化器的视频捕获设备。
要求
要求 | 价值 |
---|---|
标头 | ksmedia.h (包括 Ksmedia.h) |