KSPROPERTY_TUNER_SCAN_STATUS
The KSPROPERTY_TUNER_SCAN_STATUS property describes the status of a scanning operation. This property can be implemented optionally.
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
No |
Pin |
KSPROPERTY_TUNER_SCAN_STATUS_S |
The property value (operation data) is a KSPROPERTY_TUNER_SCAN_STATUS_S structure that specifies the status of a scanning operation.
Remarks
The KsTvTune.ax module can call the driver's KSPROPERTY_TUNER_SCAN_STATUS property at any time. However, KsTvTune.ax typically calls KSPROPERTY_TUNER_SCAN_STATUS after it calls the KSEVENT_TUNER_INITIATE_SCAN event to set up a scan operation and to set up notification for when the scan completes. KsTvTune.ax then waits for the scan-completion notification to occur. As the worst case scenario, KsTvTune.ax waits for the amount of time that is specified in the SettlingTime member of the TUNER_ANALOG_CAPS_S structure. The driver should have returned a populated TUNER_ANALOG_CAPS_S from a call to its KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS property with the ANALOG_TV_NETWORK_TYPE value set in the NetworkType member of the KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S structure. However, the tuner should typically determine the status of the signal quicker than the amount of time that is specified in SettlingTime and should then notify KsTvTune.ax that the scan completed by signaling the event.
The driver returns scan status only if the tuning device supports hardware-assisted scanning. The driver indicates such support by setting the fSupportsHardwareAssistedScanning member of the KSPROPERTY_TUNER_SCAN_CAPS_S structure to TRUE in a call to its KSPROPERTY_TUNER_SCAN_CAPS property. The driver should signal an event and return one of the following lock types in the LockStatus member of the KSPROPERTY_TUNER_SCAN_STATUS_S structure:
Tuner_LockType_None if the tuning device could not find any signal at all.
Tuner_LockType_Locked if the tuning device locked onto the exact frequency.
Requirements
Version |
Available in Windows Vista and later versions of the operating system. |
Header |
Ksmedia.h (include Ksmedia.h) |
See also
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S