LinksPoint GPS Toolkit Reference
GpsLoggerGetRecordCountEx
GPS Logger Functions | See Also
Causes a GPS logger to respond with GPSNOTIFY_LOGGER_RECORD_COUNT
Parameters
Parameters Description
PGPSLOGGER_RECORD_INFO pglriInfo Pointer to a GPSLOGGER_RECORD_INFO structure specifying the time range over which to count the records

Return Value
  • GPSERROR_NONE if the command executes successfully

  • GPSERROR_INVALID_PARAMETER if a NULL pointer is passed in pglriInfo

  • 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 differs from GpsGetRecordCount in that filtering is supported through the input parameter.

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

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

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

  • To retrieve the record count 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 the count of all records, set both the glrtStart and glrtEnd members of pglriInfo to zero values and the ulStart and ulEnd to GPSLOGGER_ALL_RECORDS.

  • This function is only supported on logger type receivers.
See Also
Group
Declaration
File
sirfapi.h
Links
Copyright ©1998-2005 Links Point Inc.