KSPROPERTY_TUNER_STATUS_S 结构 (ksmedia.h)
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
指定已初始化的 KSPROPERTY 结构，该结构描述属性集、属性 ID 和请求类型。
CurrentFrequency
指定当前调谐器频率。 此值以hz (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 的电视捕获。 如果调谐器设备支持无线电优化，请参阅 使用无线电调谐器的视频捕获设备。
要求
| 要求 | 值 |
|---|---|
| Header | ksmedia.h (包括 Ksmedia.h) |