Partager via


GPS Intermediate Driver Input Source Registry Settings

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The GPS Intermediate Driver uses the registry to determine the input source from which it retrieves GPS data. The input source is often physical GPS hardware accessible through a COM port (whether that COM port represents a physical serial port, a Compact Flash card, or some other input device).

For more information about configuring the GPS Intermediate Driver, see Configuring the GPS Intermediate Driver. For examples of these registry settings, see Example GPS Intermediate Driver Registry Settings.

Note

On some target devices, the root GPS Intermediate Driver registry key, and all subkeys, are protected. On these target devices, untrusted applications can read but cannot write GPS Intermediate Driver settings.

The HKEY_LOCAL_MACHINE\System\CurrentControlSet\GPS Intermediate Driver\Drivers key contains the CurrentDriver entry, which is a pointer to a subkey that contains information about the particular input source. This level of indirection enables you to switch between input sources by changing the value of this entry. For more information about changing GPS Intermediate Driver Settings, see Refreshing GPS Intermediate Driver Configuration using IOCTL_SERVICE_REFRESH.

The following table shows the named value for this key.

Value : type Description

CurrentDriver : REG_SZ

No default setting.

Name of the registry key, located beneath this key, that contains the connection information to be used to retrieve GPS location data.

Each input source used by the GPS Intermediate Driver requires its own key beneath the HKEY_LOCAL_MACHINE\System\CurrentControlSet\GPS Intermediate Driver\Drivers registry key. The value of the CurrentDriver entry specifies which of these keys supplies connection information.

For example, an input source that uses GPS hardware accessible at a specific COM port might have registry settings at the HKEY_LOCAL_MACHINE\System\CurrentControlSet\GPS Intermediate Driver\Drivers\AcmeGPSHardware key. To use the data from this hardware device, the CurrentDriver entry must contain the value "AcmeGPSHardware".

The following table shows the input source registry entries beneath each input source key.

Value : type Description

FriendlyName : REG_SZ

No default setting.

Friendly and human-readable name of the input source. For example, could be "ACME GPS Card, version 1.23." The GPSGetDeviceState function fills a GPS_DEVICE instance that includes the szGPSFriendlyName field, which contains this value.

InterfaceType : REG_SZ

No default setting.

Type of data provided by the input source. Can be "COMM", "File", or "Poll".

Input sources of type COMM usually access physical GPS hardware. For more information about the settings relevant for input sources of this type, see GPS Intermediate Driver GPS Hardware Registry Settings.

Input sources of type File use information retrieved from a static file, for testing purposes. For more information about input sources of this type, see GPS Intermediate Driver File Registry Settings.

Input sources of type Poll retrieve information from GPS hardware, without using NMEA strings. For more information about the settings relevant for input sources of this type, see GPS Intermediate Driver Poll Registry Settings.

See Also

Concepts

GPS Intermediate Driver Registry Settings