GetSatelliteInfo Method
Returns the azimuth, elevation, and signal-to-noise ratio for the specified satellite.
Syntax
Visual Basic
object.GetSatelliteInfo [in] SatellitePRN, [out] Azimuth, [out] Elevation, [out] SignalToNoiseRatio
Visual C++
object.GetSatelliteInfo([in] SatellitePRN, [out] *pAzimuth, [out] *pElevation, [out] VARIANT *pSignalToNoiseRatio)
| Part
| Description |
| object |
An object expression that evaluates to a GPS ToolKit object. |
| SatellitePRN |
A VARIANT containing the satellite PRN (unique ID) number.
|
| Azimuth |
A VARIANT (type VT_I2/short) containing the azimuth in degrees of the specified satellite.
|
| Elevation |
A VARIANT (type VT_I2/short) containing the elevation in degrees of the specified satellite.
|
| SignalToNoiseRatio |
A VARIANT (type VT_I2/short) containing the signal to noise raio in dB of the specified satellite.
|
Example
Visual Basic
Dim azimuth, elevation, snr
'Get info for satellite #18
myGPSToolKit.GetSatelliteInfo 18, azimuth, elevation, snr
Visual C++
_variant_t vtAzimuth, vtElevation, vtSnr;
short azimuth, elevation, snr;
//Get info for satellite #18
_variant_t vtSatPRN((short)18);
m_myGPSToolKit.GetSatelliteInfo(vtSatPRN, &vtAzimuth, &vtElevation, &vtSnr);
azimuth = (short)vtAzimuth;
elevation = (short)vtElevation;
snr = (short)vtSnr;
Remarks
If azimuth, elevation, or signal-to-noise ratio is not available for the specified
satellite, the associated variable will be empty (type VT_EMPTY).
Returns
Nothing
Errors
None
See Also
SatelliteInViewPRNs property, FixSatellitePRNs property, NumSatellitesInView property,
NumSatellitesInFix property, OnSatelliteUpdate event
|
