Initializes the GPS Toolkit

If the GPS library is successfully initialized, then the return value will be GPSERROR_NONE. Otherwise, it will be one of the following error codes: GPSERROR_INVALID_PARAMETER, GPSERROR_MATHLIB (Palm OS)

• See the Autodetect topic for special settings to initiate an automatic GPS receiver detection.

• Set geEnable to false and use GpsEnable to start the GPS later if the application needs to set up objects before the GPS communications start.

• The iPort value should be 1 for COM1:, 2 for COM2:, etc.

• When enabled with geEnable = GPSENABLE_TRUE, the GPS library will start a new thread that constantly monitors the GPS device.

• The iPort value will represent the number of the port as reported by the GpsGetPortList function. For example, a value of 1 represents the first entry in the port list, 2 represents the second entry in the port list, etc.

• The GpsInitialize function will also initialize the MathLib 1.1 library, allowing your application to use any of the MathLib 1.1 floating point functions.

GPSPROTOCOL, GPSENABLE, GpsEnable, GpsTerminate

Generic GPS Functions

GPSERROR GPSAPI GpsInitialize(long lPort, unsigned long ulBaudRate, GPSPROTOCOL gpProtocol, GPSENABLE geEnable);

gpsapi.h

gpsapi.h, Generic GPS Functions, See Also