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