Share via

структура 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 , которая описывает набор свойств, идентификатор свойства и тип запроса.

CurrentFrequency

Указывает текущую частоту тюнера. Это значение в герцах (Гц).

PLLOffset

Указывает смещение цикла блокировки фазы (PLL) в кратных значениях детализации настройки. Используется, если стратегия тюнера KS_TUNER_STRATEGY_PLL. Если стратегия тюнера не KS_TUNER_STRATEGY_PLL, это значение не имеет смысла. В следующей таблице показано значение, возвращаемое мини-накопителем для различных условий настройки при условии, что степень детализации настройки составляет 62,5 кГц:

Смещение частоты 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)

См. также раздел

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER