次の方法で共有

KSPROPERTY_TUNER_SCAN_STATUS

  • [アーティクル]

KSPROPERTY_TUNER_SCAN_STATUS プロパティは、スキャン操作の状態を記述します。 このプロパティは、必要に応じて実装できます。

使用方法概要表

取得 設定 対象 プロパティ記述子の種類 プロパティ値の種類

はい

いいえ

ピン

KSPROPERTY_TUNER_SCAN_STATUS_S

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

関連項目

KSEVENT_TUNER_INITIATE_SCAN

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S

KSPROPERTY_TUNER_SCAN_CAPS

KSPROPERTY_TUNER_SCAN_CAPS_S

KSPROPERTY_TUNER_SCAN_STATUS_S

TUNER_ANALOG_CAPS_S