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 に設定する必要があります。

注釈

PLLOffset メンバーと SignalStrength メンバーの詳細については、「PCI ベースの TV キャプチャ」を参照してください。 チューナー デバイスでラジオ チューニングがサポートされている場合は、「 Video Capture Devices with Radio Tuners」を参照してください。

要件

要件 値
Header ksmedia.h (Ksmedia.h を含む)

こちらもご覧ください

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER