структура 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) |