GPSOpenDevice

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function creates a connection to the GPS Intermediate Driver.

Syntax

HANDLE GPSOpenDevice(
  HANDLE       hNewLocationData,
  HANDLE       hDeviceStateChange,
  const WCHAR *szDeviceName,
  DWORD        dwFlags
);

Parameters

  • hNewLocationData
    Handle to a Windows Embedded CE event created using CreateEvent, or NULL. The GPS Intermediate Driver signals the passed event whenever it has new GPS location information.
  • hDeviceStateChange
    Handle to a Windows Embedded CE event created using CreateEvent, or NULL. The GPS Intermediate Driver signals the passed event whenever the state of the device changes.
  • szDeviceName
    Reserved. Must be NULL.
  • dwFlags
    Reserved. Must be 0. **

Return Value

If successful, returns a handle to the GPS Intermediate Driver.

If unsuccessful, returns NULL.

Requirements

Header gpsapi.h
Library Gpsapi.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GPS Intermediate Driver Functions

Concepts

GPS Intermediate Driver Power Management
Accessing Parsed GPS Data

Other Resources

CreateEvent
CreateFile
GetLastError