/////////////////////////////////////////////////////////////////////////////////////////////
//GPS.h
/////////////////////////////////////////////////////////////////////////////////////////////


#ifndef __GPS_H__
#define __GPS_H__


#ifdef __cplusplus
extern "C" {
#endif

#define GPS_MaxDeviceName 256

DECLARE_HANDLE( HGPS );
#define LPHGPS HGPS*

#define GpsQualityFixNotAvailable 0
#define GpsQualityFix             1
#define GpsQualityDifferentialFix 2

#define GpsParityNone  0
#define GpsParityOdd   1
#define GpsParityEven  2

#define GpsStopBits1       0
#define GpsStopBits1Point5 1
#define GpsStopBits2       2

typedef struct tagGPSDEVINFO
{
  TCHAR szDeviceName[ GPS_MaxDeviceName + 1 ];  /* GPS 設備名稱 */
  BOOL  bDefaultReceiver;                       /* 當前GPS設備是否是缺省接收設備 */
  WORD  wCommPort;                              /* 正在使用的命令口 */
  DWORD dwCommBaudRate;                         /* 使用命令口的波特率 */
  WORD  wCommDataBits;                          /* 使用命令口的比特位 */
  WORD  wCommParity;                            /* 枚舉使用命令口的奇偶類型 */
  WORD  wCommStopBits;                          /* 枚舉使用命令口的停止位 */
} GPSDEVINFO, *PGPSDEVINFO, NEAR *NGPSDEVINFO, FAR *LPGPSDEVINFO;

typedef CONST FAR GPSDEVINFO *LPCGPSDEVINFO;


typedef struct tagGPSPOSITION
{
  /* 緯度信息 */
  BOOL bNorthing;           /* 真為北緯，假為南緯 */
  DWORD dwLatitude;         /* 緯度 */

  /* 精度信息 */
  BOOL bEasting;            /* 真為東經，假為西經 */
  DWORD dwLongitude;        /* 經度 */

  /* 方位信息 */
  DWORD dwBearing;          

  /* 速度信息 */
  DWORD dwSpeed;          

  /* 校正時間 */
  WORD wFixYear;
  WORD wFixMonth;
  WORD wFixDay;
  WORD wFixHour;
  WORD wFixMinute;
  WORD wFixSecond;

  /* 衛星信息 */
  WORD nSatellites;         /*可見衛星數*/ 

  /* 海拔高度信息 */
  DWORD dwAntennaAltitude;  

  //質量指示
  WORD wQualityIndicator;   
} GPSPOSITION, *PGPSPOSITION, NEAR *NGPSPOSITION, FAR *LPGPSPOSITION; 

typedef CONST FAR GPSPOSITION *LPCGPSPOSITION;

BOOL  GpsShowControlPanel();
BOOL  GpsCreateEntry(HWND hWnd);
DWORD GpsGetNumDevices();
DWORD GpsEnumDevices(LPGPSDEVINFO lpGpsDevInfo, DWORD dwRequestedDevices);
BOOL  GpsDeleteEntry(LPCTSTR lpszEntry);
BOOL  GpsRenameEntry(LPCTSTR lpszOldEntry, LPCTSTR lpszNewEntry);
BOOL  GpsPropertiesDlg(HWND hWnd, LPCTSTR lpszEntry);
HGPS  GpsOpen(LPCTSTR lpszEntry);
BOOL  GpsClose(HGPS hEntry);
BOOL  GpsGetPosition(HGPS hEntry, LPGPSPOSITION lpPosition);
DWORD GpsGetVersion();
BOOL  GpsDeviceNameAlreadyExists(LPCTSTR lpszEntry);
void  GpsShowAboutBox(HWND hWnd);
BOOL  GpsGetDevice(LPCTSTR lpszEntry, LPGPSDEVINFO lpGpsDevInfo);
BOOL  GpsSetDevice(LPCTSTR lpszEntry, LPCGPSDEVINFO lpGpsDevInfo);

#ifdef __cplusplus
}
#endif


#endif //__GPS_H__