KSPROPERTY_TUNER_SCAN_STATUS

KSPROPERTY_TUNER_SCAN_STATUS 屬性描述掃描作業的狀態。 這個屬性可以選擇性地實作。

使用量摘要表格

Get Set 目標 屬性描述元類型 屬性值類型

No

Pin

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 屬性傳回填入的TUNER_ANALOG_CAPS_S,並在KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S 結構的 NetworkType 成員中設定 ANALOG_TV_NETWORK_TYPE 值。 不過,微調器通常應該判斷訊號的狀態比 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