KSPROPERTY_BDA_SIGNAL_QUALITY
Clients use KSPROPERTY_BDA_SIGNAL_QUALITY to determine the amount of data successfully extracted from the signal as a percent.
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
| Yes | Yes | Pin or Filter | KSP_NODE | LONG |
Remarks
The NodeId member of KSP_NODE specifies the identifier of the control node or is set to −1 to specify a pin.
The returned value specifies the data that is extracted from the signal as a percent.
The demodulation node typically reports signal quality, which is a representation of how much of the original data could be extracted from the signal.
In the case of analog signals, this percentage can be computed by examining the timing of horizontal sync (HSync) and vertical sync (VSync) as well as by looking at information contained in horizontal-blanking (HBlanking) and vertical-blanking (VBlanking) intervals.
In the case of digital signals, this percentage can be computed by examining packet cyclic redundancy checks (CRC) and forward error correction (FEC) confidence values as follows:
100 percent is ideal.
95 percent shows very little (almost unnoticeable) artifacts when rendered.
90 percent contains few enough artifacts as to be easily viewable.
80 percent is the minimum level to be viewable.
60 percent is the minimum level to expect data services, including receiving an electronic program guide (EPG), to work.
20 percent indicates that the demodulator is aware that a properly modulated signal exists but cannot produce enough data to be useful.
Requirements
Header: bdamedia.h (include Bdamedia.h)