IOCTL_GPS_DRIVER_GET_LOCATION_V1
In the future, the GPS Intermediate Driver may call this IOCTL to retrieve location information directly, instead of using ReadFile and parsing the returned NMEA strings.
The GPS Intermediate Driver will only use this IOCTL when the GPS hardware is configured using an input source of type Poll. For more information about this type of input source, see GPS Intermediate Driver Poll Registry Settings.
Note The GPS Intermediate Driver does not currently use this IOCTL, and always uses ReadFile to interact with GPS hardware. This information is provided so that devices that implement this IOCTL can work with a possible future version of the GPS Intermediate Driver that does use this IOCTL.
Parameters
The lpOutBuffer parameter to DeviceIOControl points to memory that must be set to a GPS_POSITION structure that contains the most recent location information obtained by the GPS hardware.
If the GPS hardware has no data, but the hardware is still functioning, the dwValidFields member of the GPS_POSITION structure should be set to 0.
Return Values
TRUE if the GPS hardware is functioning, even if there was no data to return.
FALSE only if there has been a fatal GPS hardware problem (for example, if the GPS hardware has been unplugged).
Requirements
OS Versions: Windows CE 5.01 and later.
Header: GPSDev.h.
See Also
GPS Intermediate Driver IOCTLs | Implementing GPS Intermediate Driver Hardware IOCTLs | DeviceIOControl | GPS_POSITION | ReadFile
Send Feedback on this topic to the authors