KSPROPERTY_TUNER_SCAN_STATUS

Artikel
02/07/2024

Die KSPROPERTY_TUNER_SCAN_STATUS-Eigenschaft beschreibt die status eines Scanvorgangs. Diese Eigenschaft kann optional implementiert werden.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Nein	Pin	KSPROPERTY_TUNER_SCAN_STATUS_S	KSPROPERTY_TUNER_SCAN_STATUS_S

Der Eigenschaftswert (Vorgangsdaten) ist eine KSPROPERTY_TUNER_SCAN_STATUS_S-Struktur, die die status eines Scanvorgangs angibt.

Hinweise

Das KsTvTune.ax-Modul kann die KSPROPERTY_TUNER_SCAN_STATUS Eigenschaft des Treibers jederzeit aufrufen. KsTvTune.ax ruft jedoch in der Regel KSPROPERTY_TUNER_SCAN_STATUS auf, nachdem es das KSEVENT_TUNER_INITIATE_SCAN-Ereignis aufgerufen hat, um einen Scanvorgang einzurichten und eine Benachrichtigung für den Abschluss der Überprüfung einzurichten. KsTvTune.ax wartet dann, bis die Benachrichtigung zum Abschluss des Scanvorgangs erfolgt. Im schlimmsten Fall wartet KsTvTune.ax auf die Zeit, die im SettlingTime-Member der TUNER_ANALOG_CAPS_S-Struktur angegeben ist. Der Treiber sollte einen aufgefüllten TUNER_ANALOG_CAPS_S von einem Aufruf seiner KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS-Eigenschaft zurückgegeben haben, wobei der ANALOG_TV_NETWORK_TYPE Wert im NetworkType-Element der KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S-Struktur festgelegt ist. Der Tuner sollte jedoch in der Regel die status des Signals schneller bestimmen als die in SettlingTime angegebene Zeitspanne und sollte dann KsTvTune.ax benachrichtigen, dass der Scan abgeschlossen wurde, indem er das Ereignis signalisiert.

Der Treiber gibt scan status nur zurück, wenn das Optimierungsgerät hardwaregestützte Überprüfungen unterstützt. Der Treiber gibt diese Unterstützung an, indem er den fSupportsHardwareAssistedScanning-Member der KSPROPERTY_TUNER_SCAN_CAPS_S-Struktur in einem Aufruf der KSPROPERTY_TUNER_SCAN_CAPS-Eigenschaft auf TRUE festlegt. Der Treiber sollte ein Ereignis signalisieren und einen der folgenden Sperrtypen im LockStatus-Member der KSPROPERTY_TUNER_SCAN_STATUS_S-Struktur zurückgeben:

Tuner_LockType_None , wenn das Optimierungsgerät überhaupt kein Signal finden konnte.
Tuner_LockType_Locked , wenn das Optimierungsgerät auf die genaue Häufigkeit gesperrt ist.