📄 gpslib.htm
字号:
<p> </p>
<p> </p>
<p><font face="Arial"><small><a name="GpsGetNumDevices"></a></small><strong><big>GpsGetNumDevices</big></strong></font></p>
<p><font face="Arial">DWORD GpsGetNumDevices();</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">The number of currently installed GPS Receivers.</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">Simple function to return the number of installed GPS devices.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsEnumDevices">GpsEnumDevices</a>, <a
href="#GpsGetDevice">GpsGetDevice</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><small><a name="GpsEnumDevices"></a></small><big><strong>GpsEnumDevices</strong></big></font></p>
<p><font face="Arial">DWORD GpsEnumDevices(LPGPSDEVINFO lpGpsDevInfo, DWORD
dwRequestedDevices);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">The number of GPS devices successfully enumerated.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>IpGpsDevInfo </em>Pointer to an array of <a href="#GPSDEVINFO">GPSDEVINFO</a>
structures which will be filled in upon return from this function.</font></p>
<p><font face="Arial"><em>dwRequestedDevices</em> The number of devices to enumerate.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">This allow you to retrieve the configuration parameters for any
installed GPS device. To enumerate all the currently installed GPS devices, you would set <em>dwRequestedDevices</em>
to the return value from GpsGetNumDevices.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsGetNumDevices">GpsGetNumDevices</a>, <a
href="#GPSDEVINFO">GPSDEVINFO</a>, <a href="#GpsGetDevice">GpsGetDevice</a></font></p>
<p class="crt"> </p>
<p class="crt"> </p>
<p class="crt"><font face="Arial"><a name="GpsDeleteEntry"></a><big><strong>GpsDeleteEntry</strong></big></font></p>
<p><font face="Arial">BOOL GpsDeleteEntry(LPCTSTR lpszEntry);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if the GPS device was successfully removed, otherwise FALSE.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>lpszEntry</em> The name of the GPS device to remove.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">Removes an installed GPS device.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsCreateEntry">GpsCreateEntry</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsRenameEntry"></a><big><strong>GpsRenameEntry</strong></big></font></p>
<p><font face="Arial">BOOL GpsRenameEntry(LPCTSTR lpszOldEntry, LPCTSTR lpszNewEntry);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if the GPS device was successfully renamed, otherwise FALSE.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>lpszOldEntry</em> The current name of the GPS device.<br>
<em>lpszNewEntry</em> The new name of the GPS device.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">Renames an already installed GPS receiver.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsCreateEntry">GpsCreateEntry</a>, <a
href="#GpsCreateEntry">GpsDeleteEntry</a></font></p>
<p> </p>
<p><font face="Arial"><a name="GpsPropertiesDlg"></a><big><strong>GpsPropertiesDlg</strong></big></font></p>
<p><font face="Arial">BOOL GpsPropertiesDlg(HWND hWnd, LPCTSTR lpszEntry);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if the properties dialog was successfully displayed and the
user closed the dialog by using the "OK" button.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>hWnd</em> The parent window to use to display the properties
dialog.<br>
<em>lpszEntry</em> The name of the GPS device to show properties for.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">Displays the properties dialog associated with an installed GPS
receiver. Internally if the dialog is closed using the "OK" button, it's
associated properties will be updated and saved.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsCreateEntry">GpsCreateEntry</a>, <a
href="#GpsCreateEntry">GpsDeleteEntry</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><strong><a name="GpsOpen"></a><big>GpsOpen</big></strong></font></p>
<p><font face="Arial">HGPS GpsOpen(LPCTSTR lpszEntry);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">An abstract HANDLE type (HGPS) which represents an open connection
to a GPS receiver. Upon return an invalid handle value is represented by the standard
Win32 value INVALID_HANDLE_VALUE</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial">lpszEntry The name of the GPS device to open a connection to. If
lpszEntry is set to NULL, then the default GPS receiver will be opened.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">This is the main function a client application would use to retrieve
GPS fix. Client applications should also provide a mechanism to bring up the control panel
applet by calling <a href="#GpsShowControlPanel">GpsShowControlPanel</a>.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsClose">GpsClose</a>, <a
href="#GpsEnumDevices">GpsEnumDevices</a>, <a href="#GpsShowControlPanel">GpsShowControlPanel</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsClose"></a><big><strong>GpsClose</strong></big></font></p>
<p><font face="Arial">BOOL GpsClose(HGPS hEntry);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if the connection to the open GPS receiver was successfully
closed.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>hEntry</em> The handle to the open GPS receiver to close.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">This function would normally be called just prior to exiting your
client GPS application.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsOpen">GpsOpen</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsGetPosition"></a><big><strong>GpsGetPosition</strong></big></font></p>
<p><font face="Arial">BOOL GpsGetPosition(HGPS hEntry, LPGPSPOSITION lpPosition);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if the GPS fix for the open GPS connection was retrieved
successfully.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>hEntry</em> The handle to the open GPS connection to retrieve a
GPS fix for.<br>
<em>lpPosition</em> A pointer to a <a href="#GPSPOSITION">GPSPOSITION</a> structure which
will be filled in upon successful return from this function.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">This function should be called periodically by client applications
after a successful call to the function <a href="#GpsOpen">GpsOpen</a>. A suggested update
period is between 1 - 5 seconds depending on the requirements of the client application.
Upon successful return the <em>lpPosition</em> can be used by the client application for
whatever purpose required, e.g. In an atlas type program<em> </em>the information could be
used to plot the users position and track over a map on the screen.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsOpen">GpsOpen</a>, <a href="#GpsClose">GpsClose</a>,
<a href="#GPSPOSITION">GPSPOSITION</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsGetVersion"></a><big><strong>GpsGetVersion</strong></big></font></p>
<p><font face="Arial">DWORD GpsGetVersion();</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">The current version of GPSLIB encoded as a DWORD.</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">Returns the version number of the GPSLIB dll. Currently 0x101 is
returned which corresponds to v1.01 of GPSLIB</font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsDeviceNameAlreadyExists"></a><big><strong>GpsDeviceNameAlreadyExists</strong></big></font></p>
<p><font face="Arial">BOOL GpsDeviceNameAlreadyExists(LPCTSTR lpszEntry);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if a the named GPS device is already installed, otherwise
FALSE.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>lpszEntry</em> The name of the GPS device to determine if it is
installed.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">Simple function which internally uses <a href="#GpsEnumDevices">GpsEnumDevices</a>
to determine if the named GPS device is already installed. It is used by the control panel
applet to ensure uniqueness of the names assigned to devices.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsEnumDevices">GpsEnumDevices</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsShowAboutBox"></a><big><strong>GpsShowAboutBox</strong></big></font></p>
<p><font face="Arial">void GpsShowAboutBox(HWND hWnd);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">None.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
<p><font face="Arial"><em>hWnd</em> The parent window to use to display the about box.</font></p>
<p><font face="Arial"><strong>Remarks</strong></font></p>
<p><font face="Arial">Simple function which displays an <em>"About Box"</em>
with version number and copyright information of GPSLIB. It is used by the control panel
applet for its <em>"about box"</em>.</font></p>
<p class="crt"><font face="Arial"><strong>See Also</strong></font></p>
<p class="crt"><font face="Arial"><a href="#GpsGetVersion">GpsGetVersion</a></font></p>
<p> </p>
<p> </p>
<p><font face="Arial"><a name="GpsGetDevice"></a><big><strong>GpsGetDevice</strong></big></font></p>
<p><font face="Arial">BOOL GpsGetDevice(LPCTSTR lpszEntry, LPGPSDEVINFO lpDevice);</font></p>
<p><font face="Arial"><strong>Return Value</strong></font></p>
<p><font face="Arial">TRUE if the device was found successfully otherwise FALSE.</font></p>
<p><font face="Arial"><strong>Parameters</strong></font></p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -