📄 gpslib.htm
字号:
<html>
<head>
<title>GPSLIB v1.02</title>
</head>
<body>
<p align="left"><font face="Arial"><img src="gpslib.gif" width="35" height="36"
alt="gpslib.gif (1100 bytes)"><big><big><big><big><strong>GPSLIB v1.02</strong></big></big></big></big></font></p>
<p><font face="Arial">Welcome to <strong>GPSLIB</strong>, a simple SDK (software
development kit) which can be used to add GPS support to your 32 bit Windows applications.
</font></p>
<table>
<tr>
<td><font face="Arial"><a href="#Features">Features</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#History">History</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#Installation">Installation & Redistribution</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#Usage">Usage</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#APIReference">API Reference</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#structures">Structures used by GPSLIB</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#Shareware">Shareware Notice</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#Enhancements">Planned Enhancements</a></font></td>
</tr>
<tr>
<td><font face="Arial"><a href="#Contact">Contacting the Author</a></font></td>
</tr>
</table>
<p> </p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="Features"></a><big><strong><big>Features</big></strong></big>
</font>
<ul>
<li><font color="#000000" size="3" face="Arial">Can be used by any development environment
which supports calling Windows DLLs including VB, VBA, C, C++, Fortran and Delphi.</font></li>
<li><font face="Arial"><font size="3"><font color="#000000">Fully supports the UNICODE
programming model.</font></font><big> </big></font></li>
<li><font face="Arial">Provides a control panel applet which is used to add, configure and
remove GPS receivers on the client's computer.</font></li>
<li><font face="Arial">Simple API which is similar to function calls in the Win32 SDK API,
meaning that it should be familiar to Windows developers.</font></li>
</ul>
<p> </p>
<p> </p>
<p> </p>
<p><font face="Arial"><big><a name="History"></a></big><font color="#000000" size="5"><strong>History</strong></font></font></p>
<p><font face="Arial"><font color="#000000" size="3"><strong>V1.0 (13th January 1998)</strong></font>
</font>
<ul>
<li><font face="Arial"><font size="3"><font color="#000000">Initial public release.</font></font><big>
</big></font></li>
</ul>
<p><strong><font color="#000000" size="3" face="Arial">V1.01 (2</font><font face="Arial"><font
size="3"><font color="#000000">0</font></font><font color="#000000" size="3">th January
1998)</font></strong> </font>
<ul>
<li><font face="Arial">A number of problems were discovered when GPSLIB was being used in a
UNICODE build (i.e it didn't work <g>). These problems have now been fixed.</font></li>
<li><font face="Arial">Mak file now includes all the possible build options for all the
GPSLIB components.</font></li>
<li><font face="Arial">Mak file no longer hard codes output to
"d:\winnt\system32". (This was due to the way I have my development system set
up).</font></li>
<li><font face="Arial">Some of the other options in the mak file such as output directories
have been tidied up</font></li>
<li><font face="Arial">Now includes Ascii release binaries in distribution.</font></li>
<li><font face="Arial">Minor updates to the documentation.</font></li>
</ul>
<p><font face="Arial" color="#000000" size="3"><strong>V1.02 (26th August 1998)</strong></font><font
face="Arial"> </font>
<ul>
<li><font face="Arial">Small change to stdafx.h to include afxcview.h in gps32exe</font></li>
<li><font face="Arial">The GpsShowControlPanel function now actually works</font></li>
<li><font face="Arial">Minor tweaks to the GPS Mak files</font></li>
<li><font face="Arial">Removed a number of unused symbols</font></li>
<li><font face="Arial">Change ID of a number of GPS32EXE menu items to avoid conflict with
new VC 6 defines.</font></li>
<li><font face="Arial">Updated all Version Infos to 1.02</font></li>
<li><font face="Arial">Removed a level 4 warning from the Test app.</font></li>
<li><font face="Arial">Removed unused toolbar from GPS CPL file</font></li>
<li><font face="Arial">GPS cpl file now uses standard F2 accelerator for Rename</font></li>
<li><font face="Arial">GPS32EXE toolbar is now shown flat</font></li>
<li><font face="Arial">Number of extra TRACE statements have been added to aid in debugging.</font></li>
</ul>
<p> </p>
<p> </p>
<p> </p>
<p><font face="Arial"><big><a name="Installation"></a></big><font color="#000000" size="5"><strong>Installation
& Redistribution</strong></font></font></p>
<p><font color="#000000" size="3" face="Arial">GPSLIB is for Win32 development only. To
help keep the download size to a minimum, there is no install program. All you need to do
is unzip the <em>"gpslib.zip"</em> file into a directory on your hard disk.</font></p>
<p><font color="#000000" size="3" face="Arial">When it comes time to distribute your
applications you will need to ship the <a href="#Usage">relevant GPSLIB dll</a> and
control panel applet. </font></p>
<p> </p>
<p> </p>
<p> </p>
<p><font face="Arial"><big><a name="Usage"></a><big><strong>Usage</strong></big></big></font></p>
<p><font color="#000000" size="3" face="Arial">To start developing client applications
using GPSLIB, all you will need to do is to link to the relevant GPSLIB DLL and then call
the <a href="#APIReference">functions</a> you want.</font></p>
<p><strong><font face="Arial" size="3">Notes for users of VC 4.x / 5.0</font></strong>
<ul>
<li><font color="#000000" size="3" face="Arial">Before you start using GPSLIB you will need
to modify your include and lib directories to include the relevant GPSLIB directories.</font></li>
<li><font color="#000000" size="3" face="Arial">If you want to rebuild any of the GPSLIB
components then open up gps32.mak file as a project workspace. This is a VC 4.x file which
if you open it in VC 5 will automatically be upgraded to the new worskpace format.</font></li>
<li><font color="#000000" size="3" face="Arial">The debug versions of the GPSLIB components
are not included in this distribution to help keep the download size to a minimum. If you
want to use these versions, then you will need to build them using the supplied mak file.</font></li>
</ul>
<p class="crt"><font class="MissingLink" meta="_WIN32_SetWindowText" face="Arial">Depending
on your build configuration you will need to link to a different version of the GPSLIB
DLL.</font></p>
<table border="1" width="32%">
<tr>
<td width="35%"><font face="Arial"><strong>Build Configuration</strong></font></td>
<td width="41%"><font face="Arial"><strong>GPSLIB DLL to link to</strong></font></td>
</tr>
<tr>
<td width="35%"><font face="Arial">Ascii Debug</font></td>
<td width="41%"><font face="Arial">GPS100D.DLL</font></td>
</tr>
<tr>
<td width="35%"><font face="Arial">Ascii Release</font></td>
<td width="41%"><font face="Arial">GPS100.DLL</font></td>
</tr>
<tr>
<td width="35%"><font face="Arial">Unicode Debug</font></td>
<td width="41%"><font face="Arial">GPS100UD.DLL</font></td>
</tr>
<tr>
<td width="35%"><font face="Arial">Unicode Release</font></td>
<td width="41%"><font face="Arial">GPS100U.DLL</font></td>
</tr>
</table>
<p><font color="#000000" size="3" face="Arial">The control panel applet consists of the
two files<em>. </em>Namely a .cpl and .exe file.</font></p>
<table border="1" width="43%">
<tr>
<td width="58%"><font face="Arial"><strong>Build Configuration</strong></font></td>
<td width="36%"><font face="Arial"><strong>Control Panel dll</strong></font></td>
<td width="55%"><font face="Arial"><strong>Control Panel Exe</strong></font></td>
</tr>
<tr>
<td width="58%"><font face="Arial">Ascii Debug</font></td>
<td width="36%"><font face="Arial">GPS100D.CPL</font></td>
<td width="21%"><font face="Arial">GPS100D.EXE</font></td>
</tr>
<tr>
<td width="58%"><font face="Arial">Ascii Release</font></td>
<td width="36%"><font face="Arial">GPS100.CPL</font></td>
<td width="21%"><font face="Arial">GPS100.EXE</font></td>
</tr>
<tr>
<td width="58%"><font face="Arial">Unicode Debug</font></td>
<td width="36%"><font face="Arial">GPS100UD.CPL</font></td>
<td width="21%"><font face="Arial">GPS100UD.EXE</font></td>
</tr>
<tr>
<td width="58%"><font face="Arial">Unicode Release</font></td>
<td width="36%"><font face="Arial">GPS100U.CPL</font></td>
<td width="21%"><font face="Arial">GPS100U.EXE</font></td>
</tr>
</table>
<p><font color="#000000" size="3" face="Arial">These two files which form the GPS control
panel applet should be installed into the system directory (system32 directory under
Windows NT) of client machines. You can install the GPSLIB dll in the system or
application directory of client machines. </font></p>
<p><font face="Arial"><font size="3"><font color="#000000">Please note that you are only
allowed to redistribute the release mode components of GPSLIB.</font></font><big> </big></font></p>
<p> </p>
<p> </p>
<p> </p>
<p> </p>
<p><font face="Arial">The debug versions are only relevant to client applications
developed in C or C++ which can take advantage of the debugging information contained in
these DLLs. This allows you to step directly into the GPSLIB source code when you are
debugging your client applications from inside IDE's such as Microsoft's <em>"Developer
Studio"</em>.</font></p>
<p> </p>
<p> </p>
<p class="crt"><font face="Arial"><a name="APIReference"></a><big><big><strong>API
Reference</strong></big></big></font></p>
<p><font face="Arial">The GPSLIB DLLs provided export a number of functions as listed
below:</font></p>
<p><font face="Arial"><a href="#GpsShowControlPanel">GpsShowControlPanel</a><br>
<a href="#GpsCreateEntry">GpsCreateEntry</a><br>
<a href="#GpsGetNumDevices">GpsGetNumDevices</a><br>
<a href="#GpsEnumDevices">GpsEnumDevices</a><br>
<a href="#GpsDeleteEntry">GpsDeleteEntry</a><br>
<a href="#GpsRenameEntry">GpsRenameEntry</a><br>
<a href="#GpsPropertiesDlg">GpsPropertiesDlg</a><br>
<a href="#GpsOpen">GpsOpen</a><br>
<a href="#GpsClose">GpsClose</a><br>
<a href="#GpsGetPosition">GpsGetPosition</a><br>
<a href="#GpsGetVersion">GpsGetVersion</a><br>
<a href="#GpsDeviceNameAlreadyExists">GpsDeviceNameAlreadyExists</a><br>
<a href="#GpsShowAboutBox">GpsShowAboutBox</a><br>
<a href="#GpsGetDevice">GpsGetDevice</a><br>
<a href="#GpsSetDevice">GpsSetDevice</a></font></p>
<p class="crt"> </p>
<p class="crt"> </p>
<p><font face="Arial"><small><small><a name="GpsShowControlPanel"></a></small></small><big><strong>GpsShowControlPanel</strong></big></font></p>
<p><font face="Arial">BOOL GpsShowControlPanel();</font></p>
<p class="rl"><font face="Arial"><strong>Return Value</strong></font></p>
<p class="t"><font face="Arial">TRUE if the applet was successfully displayed otherwise
FALSE.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial">None.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">Brings up the GPS Receivers Control Panel Applet. This allows you to
install, configure and remove GPS Receivers on your system.</font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><small><small><a name="GpsCreateEntry"></a></small></small><big><strong>GpsCreateEntry</strong></big></font></p>
<p><font face="Arial">BOOL GpsCreateEntry(HWND hWnd);</font></p>
<p class="rl"><font face="Arial"><strong>Return Value</strong></font></p>
<p class="t"><font face="Arial">TRUE if a new GPS receiver was installed otherwise FALSE.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>hWnd</em> The parent window to be used for user interface
elements which are displayed by this functions.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">This brings up a standard wizard based dialog to allow the user to
install a GPS receiver on their computer.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsCreateEntry">GpsDeleteEntry</a>, <a
href="#GpsGetDevice">GpsGetDevice</a></font></p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -