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)

另请参阅

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER