Click to Rate and Give Feedback
Collapse All/Expand All Collapse All
GPS_DEVICE
Windows Mobile SupportedWindows Embedded CE Supported
8/28/2008

This structure contains information about the GPS Intermediate Driver and GPS hardware used by the GPS Intermediate Driver.

To retrieve the data represented by this structure, call GPSGetDeviceState.


typedef struct _GPS_DEVICE {
   DWORD    dwVersion;
   DWORD    dwSize;
   DWORD    dwServiceState;
   DWORD    dwDeviceState;
   FILETIME ftLastDataReceived;
   WCHAR    szGPSDriverPrefix[GPS_MAX_PREFIX_NAME];
   WCHAR    szGPSMultiplexPrefix[GPS_MAX_PREFIX_NAME];
   WCHAR    szGPSFriendlyName[GPS_MAX_FRIENDLY_NAME];
   GPS_DEVICE_STATUS    gdsDeviceStatus;
} *PGPS_DEVICE, GPS_DEVICE;
dwVersion

Version of the GPS Intermediate Driver expected by the application. Must be set before the structure is passed to GPSGetDeviceState.

Must be GPS_VERSION_1.

dwSize

Size of the structure, in bytes. Must be set before the structure is passed to GPSGetDeviceState.

dwServiceState

State of the GPS Intermediate Driver. Contains one of the SERVICE_STATE values defined IOCTL_SERVICE_STATUS.

dwDeviceState

State of the driver controlling the GPS hardware. Contains one of the SERVICE_STATE values defined in IOCTL_SERVICE_STATUS.

ftLastDataReceived

Most recent time the GPS Intermediate Driver received information from the GPS hardware. This time is based on UTC according to the local system clock, not the clock information used by GPS satellites.

szGPSDriverPrefix

Prefix string used to open the GPS hardware. This entry is defined by the CommPort registry entry for hardware that connects through a serial (or virtual serial) interface. This entry is empty when the GPS Intermediate Driver reads information from static files. For more information about GPS hardware registry settings, see GPS Intermediate Driver GPS Hardware Registry Settings.

szGPSMultiplexPrefix

Prefix string used to open the GPS Intermediate Driver multiplexer. This entry is defined by the DriverInterface registry entry in the Multiplexer key. For more information about multiplexer registry settings, see GPS Intermediate Driver Multiplexer Registry Settings.

For more information about accessing data using the GPS Intermediate Driver multiplexer, see Accessing Raw GPS Data.

szGPSFriendlyName

Friendly name of the GPS hardware currently used by the GPS Intermediate Driver. This entry is defined by the FriendlyName registry entry. For more information about this registry entry, see GPS Intermediate Driver Input Source Registry Settings.

Headergpsapi.h
Windows Embedded CEWindows Embedded CE 6.0 and later
Windows MobileWindows Mobile Version 5.0 and later
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker