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

指定描述属性集、属性 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

言论

有关 PLLOffsetSignalStrength 成员的详细信息,请参阅 基于 PCI 的电视捕获。 如果优化器设备支持无线电优化,请参阅 带有无线电优化器的视频捕获设备

要求

要求 价值
标头 ksmedia.h (包括 Ksmedia.h)

另请参阅

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER