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 を含む) |