LinksPoint GPS Toolkit Reference
Up | Next
GpsEnable
gpsapi.h | Generic GPS Functions | See Also
Enables or disables communication with the GPS device
Parameters
Parameters Description
GPSENABLE geEnable GPSENABLE_TRUE to enable the use of the GPS device and begin communications, GPSENABLE_FALSE to disable GPS communications
Return Value
If the GPS library is successfully enabled, then the return value will be GPSERROR_NONE. Otherwise the return value will be GPSERROR_INVALID_PARAMETER.
Remarks
When enabled, the GPS library will open the communications port set by the GpsInitialize or GpsSetPort functions. When disabled, the communications ports will be closed.
Windows
When enabled, the GPS library will start a new thread that constantly monitors the GPS device. When disabled, this thread will be shut down.
Palm OS
Since the Palm OS cannot handle threads, communications with the GPS device is not handled in the background like it is under Windows. Instead, you must continuously call the GpsCheckForData function to check you incoming GPS data.
See Also
Group
Declaration
GPSERROR GPSAPI GpsEnable(GPSENABLE geEnable);
File
Links
Copyright ©1998-2005 Links Point Inc.