KSPROPERTY_TUNER_SCAN_STATUS
KSPROPERTY_TUNER_SCAN_STATUS 屬性描述掃描作業的狀態。 這個屬性可以選擇性地實作。
使用量摘要表格
Get | Set | 目標 | 屬性描述元類型 | 屬性值類型 |
---|---|---|---|---|
是 |
No |
Pin |
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) |
另請參閱
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S