KSPROPERTY_TUNER_SCAN_STATUS
KSPROPERTY_TUNER_SCAN_STATUS プロパティは、スキャン操作の状態を記述します。 このプロパティは、必要に応じて実装できます。
使用方法概要表
| 取得 | 設定 | 対象 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
はい |
いいえ |
ピン |
KSPROPERTY_TUNER_SCAN_STATUS_S |
プロパティ値 (操作データ) は、スキャン操作の状態を指定する KSPROPERTY_TUNER_SCAN_STATUS_S 構造体です。
備考
KsTvTune.ax モジュールは、ドライバーの KSPROPERTY_TUNER_SCAN_STATUS プロパティをいつでも呼び出すことができます。 ただし、KsTvTune.ax は通常、KSEVENT_TUNER_INITIATE_SCAN イベントを呼び出した後に KSPROPERTY_TUNER_SCAN_STATUS を呼び出してスキャン操作を設定し、スキャンが完了したときに通知を設定します。 KsTvTune.ax スキャン完了通知が発生するまで待ちます。 最悪のシナリオの場合、KsTvTune.ax は、TUNER_ANALOG_CAPS_S 構造体の SettlingTime メンバーで指定された時間にわたって待ちます。 ドライバーは、KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S 構造体の NetworkType メンバーに設定された ANALOG_TV_NETWORK_TYPE 値を使用して、KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS プロパティの呼び出しから設定された TUNER_ANALOG_CAPS_S を返している必要があります。 ただし、通常、チューナーは、信号の状態を、SettlingTime で指定された時間よりも早く判断し、イベントの通知によってスキャンが完了したことを KsTvTune.ax に通知する必要があります。
ドライバーは、チューニング デバイスがハードウェア支援スキャンをサポートしている場合にのみ、スキャンの状態を返します。 ドライバーは、KSPROPERTY_TUNER_SCAN_CAPS プロパティの呼び出しで、KSPROPERTY_TUNER_SCAN_CAPS_S 構造体の fSupportsHardwareAssistedScanning メンバーを TRUE に設定することで、このようなサポートを示します。 ドライバーは、イベントを通知し、KSPROPERTY_TUNER_SCAN_STATUS_S 構造体の LockStatus メンバーで次のいずれかのロックの種類を返す必要があります。
Tuner_LockType_None (チューニング デバイスが信号をまったく見つけられなかった場合)。
Tuner_LockType_Locked (チューニング デバイスが正確な周波数にロックされている場合)。
要件
バージョン |
Windows Vista 以降のバージョンのオペレーティング システムで使用できます。 |
ヘッダー |
ksmedia.h (Ksmedia.h を含む) |
関連項目
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S