LinksPoint GPS Toolkit Reference
GpsLoggerGetRecordsEx
GPS Logger Functions | See Also
Causes a GPS logger to respond with one or more of its data records
Parameters
Parameters Description
PGPSLOGGER_RECORD_INFO pglriInfo Pointer to a GPSLOGGER_RECORD_INFO structure specifying the records to be retrieved
GPSLOGGERFORMAT glfFormat GPSLOGGERFORMAT value specifying either ASCII or binary data
Return Value
  • GPSERROR_NONE if the command executes successfully

  • GPSERROR_INVALID_PARAMETER if a either of the input parameters are incorrect

  • GPSERROR_MEMORY if there is not enough memory available to execute the command

  • GPSERROR_INVALID_RECEIVER if the receiver type is not supported
Remarks
  • This function is supported only on GPS logger receivers.

  • The logger will respond with one or more GPSNOTIFY_LOGGER_DATA_EX notifications.

  • This function differs from GpsLoggerGetRecords in that a subset of records can be specified using the pglriInfo parameter.

  • To retrieve records between two dates, supply non-zero values for the glrtStart and glrtEnd members of the pglriInfo parameter.

  • To retrieve records after a certain date, set the glrtStart member of pglriInfo to a non-zero value and the glrtEnd member to zero.

  • To retrieve records before a certain date, set the glrtStart member of pglriInfo to zero and the glrtEnd member to a non-zero value.

  • To retrieve records by sequence number, set both the glrtStart and glrtEnd members of pglriInfo to zero values and the ulStart and ulEnd to the start and end sequence numbers respectively.

  • To retrieve all records, set both the glrtStart and glrtEnd members of pglriInfo to zero values and the ulStart and ulEnd to GPSLOGGER_ALL_RECORDS.
See Also
Group
Declaration
File
sirfapi.h
Links
Copyright ©1998-2005 Links Point Inc.