KSPROPERTY_TUNER_STATUS_S - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ksmedia.h
typedef struct {
KSPROPERTY Property;
ULONG CurrentFrequency;
ULONG PLLOffset;
ULONG SignalStrength;
ULONG Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;
View the official Windows Driver Kit DDI referenceNo description available.
The KSPROPERTY_TUNER_STATUS_S structure describes the progress of a tuning operation for TV and radio tuner devices, including present tuning frequency.
PropertySpecifies an initialized KSPROPERTY structure that describes the property set, property ID, and request type.
CurrentFrequencySpecifies the current tuner frequency. This value is in hertz (Hz).
PLLOffsetSpecifies the phase locked loop (PLL) offset in multiples of the tuning granularity. This is used if the tuner strategy is KS_TUNER_STRATEGY_PLL. If the tuner strategy is not KS_TUNER_STRATEGY_PLL, this value has no meaning. The following table demonstrates the value to be returned by the minidriver for various tuning conditions, assuming the tuning granularity is 62.5kHz:
| Frequency Offset | PLLOffset |
|---|---|
| +125,000 | +2 |
| +62,500 | +1 |
| Perfectly tuned | 0 |
| -62,500 | -1 |
| -125,000 | -2 |
SignalStrengthSpecifies the amplitude of the signal. This is used if the tuner strategy is KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Regardless of the tuning strategy supported by the minidriver, the valid values for this member are:
| Value | Meaning |
|---|---|
| -1 | Strength not Available. |
| 0 | Not on an acceptable frequency. |
| 1 | On an acceptable frequency. |
BusyIndicates if the minidriver is presently busy with the process of tuning. This member must be set to TRUE if the minidriver is currently tuning to a channel. Otherwise, if the minidriver is not currently tuning to a new channel, this member must be set to FALSE.
For more information about the PLLOffset and SignalStrength members see PCI based TV capture. If your tuner device supports radio tuning, see Video Capture Devices with Radio Tuners.