Argox PT-90 Mobile Computers under Microsoft® Windows® CE6.0 Operating System. It gives all the details needed to call functional subroutines controling the devices on the Argox PT-90 Mobile Computer or access value-added devices on board such as Scanning and Wireless module.
SDK Functions When using SDK to develop their own application program, the programmer should link DLL file or LIB file, then, include header file SYSAPIAX.H. The following two examples are given to show how to use LIB file and DLL file while developing an application program.
SYSAPIAX.DLL In PT-90 SDK, we provide SYSAPIAX.DLL which includes several functions to allow programmer to control device drivers and system functions. Programmer can use WINCE develop tool like Visual Studio 2005 to develop application programs. Descriptions of all these functions are given below.
System Related Functions CallSuspend – Enter SUSPEND mode. EnableAutoConnect – Turn auto-connect ON or OFF. RegisterAlphaKeyNotification – Register a request to send a prompt message when the ALPHA key is pressed. ShowChineseIME – DISPLAY or HIDE the Chinese IME. ...
EndSearchBTDevice – frees the search handle. InitSearchFTPDevice – Initial search the device supported FTP service. FindFirstFTPDevice – Get first device supported FTP service position. FindNextFTPDevice – Get next device supported FTP service position. PairDevice – Pair with device. ...
Audio Related Functions Audio_GetV olume To query the current audio volume level setting. DWORD Audio_GetV olume LPDWORD lpdwV olume Parameters lpdwV olume [out] The current volume level setting. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned value is E_FUNC_ERROR.
Audio_SetV olume To set the audio volume level. DWORD Audio_SetV olume DWORD dwV olume Parameters dwV olume [in] Specifies a new volume level setting. The default level is 0x99999999. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned value is E_FUNC_ERROR.
Battery Related Function GetBatteryStatus To get main battery status. int GetBatteryStatus Parameters None. Returned V alues The returned value can be one of the values in the table below. Return value Description battery high battery low battery critical battery charging no battery battery unknown Example...
Page 19
case 3: AfxMessageBox(_T("Battery Charging")); break; case 4: AfxMessageBox(_T("No Battery")); break; case 5: AfxMessageBox(_T("Battery Unknown")); break; Requirements OS V ersions: Windows CE 6.0 or beyond Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Display Related Functions BacklightOn To turn ON or OFF the LCD screen back-light. DWORD BacklightOn BOOL Parameters [in] Flag that indicates whether to turn ON screen back-light(TRUE) or turn OFF screen back-light(FALSE). Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
Display_QueryBacklightIntensity To return the back-light intensity of external power and battery power. DWORD Display_QueryBacklightIntensity LPDWORD lpdwACBacklight, LPDWORD lpdwBatteryBacklight Parameters lpdwACBacklight [out] The backlight intensity of external power. lpdwBatteryBacklight [out] The backlight intensity of battery power. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_NULLPTR.
Page 22
Example DWORD dwResult, dwV alue1, dwV alue2; dwResult = Display_QueryBacklightIntensity(&dwV alue1, &dwV alue2); if(dwResult != E_FUNC_SUCCEED) AfxMessageBox(_T("Display_QueryBacklightIntensity fail")); else CString strTemp; strTemp.Format(_T("AC backlight intensity: %d, Battery backlight intensity: %d"), dwV alue1, dwV alue2); AfxMessageBox(strTemp); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
GetBacklightStatus To get screen back-light status. DWORD GetBacklightStatus Parameters None. Returned V alues The returned value indicates whether screen back-light is: 1 = screen back-light is ON; or 0 = screen back-light is oOFF. Example DWORD dwResult; dwResult = GetBacklightStatus(); if(dwResult == 1) AfxMessageBox(_T("Backlight on"));...
PowerOnLCD To turn ON or OFF the LCD screen power. DWORD PowerOnLCD BOOL Parameters [in] Flag that indicates whether to turn ON (TRUE) or OFF (FALSE) the LCD power. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
SetBacklightPWM To adjusts the LCD screen back-light brightness. DWORD SetBacklightPWM int nACPowerPercent, nBatteryPercent Parameters nACPowerPercent,nBatteryPercent [in] One is the brightness level setting when the terminal is using AC power and the other is the brightness level setting when the terminal is using battery power. These two settings must be one of the values in the table below.
EnableTouchPanel To ENABLE or DISABLE the touch panel. DWORD EnableTouchPanel BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable(TRUE) or disable(FALSE) the touch panel. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR.
GetTouchPanelStatus To get touch panel status. DWORD GetTouchPanelStatus LPBOOL lpbEnable Parameters lpbEnable [out] Receive the touch panel status. The returned value can be one of the values in the table below V alue Touch panel status Touch panel disable Touch panel enable Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED.
KeyPad Related Functions EnablePowerButton To ENABLE or DISABLE the POWER button. DWORD EnablePowerButton BOOL Parameters [in] Flag that indicates whether to ENABLE the POWER button(TRUE) or to DISABLE the POWER button(FALSE). Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
GetKeypadAlphaMode To get the current keypad INPUT mode. DWORD GetKeypadAlphaMode Parameters None. Returned V alues The returned value can be one of the values in the table below. Return value Alpha mode numeric mode lowercase letter mode uppercase lette mode Example DWORD dwResult;...
SendKbdVirtualKey To send a VIRTUAL KEY to key buffer. DWORD SendKbdVirtualKey BYTE Parameters [in] Specifies a virtual-key code. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned value is E_FUNC_PAR_ERROR. Example CString strTemp;...
SetKeypadAlphaMode To change keypad INPUT mode. DWORD SetKeypadAlphaMode nMode Parameters nMode [in] Flags for setting INPUT mode. This parameterer must be one of the values in the table below. Value Alpha mode numeric mode lowercase letter mode uppercase letter mode Returned V alues If this action succeeds, the returnedvalue is E_FUNC_SUCCEED.
LED Related Functions GetKeypadLEDStatus To get keypad back-light LED status. BOOL GetKeypadLEDStatus Parameters None. Returned V alues The returned value indicates whether keypad back-light LED is ON(TRUE) or OFF(FALSE). Example BOOL bResult; bResult = GetKeypadLEDStatus(); if(bResult == TRUE) AfxMessageBox(_T("Keypad LED on")); else if(bResult == FALSE) AfxMessageBox(_T("Keypad LED off"));...
GoodReadLEDOn To turn ON or OFF the goodread LED. DWORD GoodReadLEDOn BOOL Parameters [in] Flag that indicates whether to turn ON(TRUE) or OFF(FALSE) the goodread LED. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
KeypadLEDOn To always turn ON or OFF the keypad LED. DWORD KeypadLEDOn BOOL Parameters [in] Flag that indicates whether to turn ON (TRUE) or OFF(FALSE) the keypad LED. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
QueryKeypadLEDIntensity To return the Keypad LED Intensity Setting when using external power and using battery power. DWORD QueryKeypadLEDIntensity LPDWORD lpdwACKeypadLED, LPDWORD lpdwBatteryKeypadLED Parameters lpdwACKeypadLED [out] The Keypad LED Intensity Setting using external power. lpdwBatteryKeypadLED [out] The Keypad LED Intensity Setting using battery power. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED.
Page 36
Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
SetKeypadPWM To adjusts Keypad LED Brightness. DWORD SetKeypadPWM int nACPowerPercent, nBatteryPercent Parameters nACPowerPercent,nBatteryPercent [in] One is to set Keypad LED Brightness setting when using AC power and the other is to set Keypad LED Brightness setting when using battery. These two parameters must be one of the values in the table below.
System Related Functions CallSuspend To force the terminal entering SUSPEND mode. void CallSuspend Parameters None. Returned V alues None. Example //suspend device CallSuspend(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
EnableAutoConnect To turn the AUTOCONNECT function ON or OFF. BOOL EnableAutoConnect BOOL bEnable Parameters bEnable [in] Flag that indicates whether ActiveSync is being automatically executed (TRUE) or not (FALSE) when user plugging host interface cable into the terminal. Returned V alues Returning TRUE if the operation is successful.
RegisterAlphaKeyNotification To Register the application to SYSAPIAX.dll, so that SYSAPIAX.dll will send a window message to the application when the Alpha Key is pressed. DWORD RegisterAlphaKeyNotification HANDLE hWnd, UINT uMsg Parameters hWnd [in] The handling window of the application to receive the message. uMsg [in] The message value to be sent when Alpha Key is pressed.
ShowChineseIME To SHOW or HIDE ChineseIME function display BOOL ShowChineseIME BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE (FALSE) the Chinese IME function display. Returned V alues Returning TRUE if the operation is successful, otherwise FALSE. Remarks The Chinese IME is only supported in Chinese OS.
ShowDesktop To SHOW or HIDE Desktop function icon display. BOOL ShowDesktop BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE(FALSE) the Desktop function icon display. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Remarks After calling this function with parameter FALSE, the terminal will HIDE all icons on Desktop.
ShowExploreToolbar To SHOW or HIDE Internet ExploreToolbar function display in Windows IE. BOOL ShowExploreToolbar BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE(FALSE) the Internet Explorer toolbar in Windows IE. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Remarks The ShowExploreT oolbar function only affects Windows Internet Explorers been opened already.
ShowTaskbar To SHOW or HIDE Taskbar function display. BOOL ShowTaskbar BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE(FALSE) Taskbar display. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Remarks After calling this function, the terminal will SHOW or HIDE Taskbar. If Taskbar is hidden by this function, it needs to call this function to display Taskbar again.
UnRegisterAlphaKeyNotification To Unregister AlphaKey Notification function request so that the application will no longer receive Alpha Key been pressed notification messages. DWORD UnregisterAlphaKeyNotification HANDLE hWnd, Parameters hWnd [in] The handling window of the application. Returned V alues Returning 0 if the operation is successful, otherwise return 1. Example if(UnregisterAlphaKeyNotification(this->m_hWnd)) AfxMessageBox(_T("UnregisterAlphaKeyNotification FAIL!!"));...
RegisterTriggerKeyNotification To Register the application to SYSAPIAX.dll, so that SYSAPIAX.dll will send a window message to the application when the trigger Key is pressed or released DWORD RegisterTriggerKeyNotification HANDLE hWnd, UINT uMsg Parameters hWnd [in] The handling window of the application to receive the message. uMsg [in] The message value to be sent when trigger Key is pressed or released Returned V alues...
UnregisterTriggerKeyNotification To Unregister triggerkey Notification function request so that the application will no longer receive trigger key been pressed or released notification messages. DWORD UnregisterTriggerKeyNotification HANDLE hWnd Parameters hWnd [in] The handling window of the application. Returned V alues Returning 0 if the operation is successful, otherwise return 1. Example if(UnregisterTriggerKeyNotification(this->m_hWnd)) AfxMessageBox(_T("UnregisterTriggerKeyNotification FAIL!!"));...
Vibrator Related Functions VibratorOn To turn ON or OFF the Vibration indicator DWORD VibratorOn BOOL Parameters [in] Flag that indicates whether to turn ON(TRUE) or OFF(FALSE) the vibration indicator. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
WLAN Related Function WL_Enable To ENABLE the WLAN function. BOOL WL_Enable Parameters None. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Example BOOL bResult; bResult = WL_Enable(); if(bResult == FALSE) AfxMessageBox(_T("Wireless enable fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
WL_Disable To DISABLE the WLAN function. BOOL WL_Disable Parameters None. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Example BOOL bResult; bResult = WL_Disable(); if(bResult == FALSE) AfxMessageBox(_T("Wireless disable fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
Bluetooth Related Function BT_On To ENABLE the Bluetooth function and power. BOOL BT_On Parameters None. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_CREA TE_FAIL, BT_ERR_INUSING. Example BOOL bResult; bResult = BT_On();...
BT_Off To DISABLE the Bluetooth function and power. void BT_Off Parameters None. Returned V alues None Example BT_Off(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
SetDiscoverMode Enable or disable terminal discovered mode. DWORD SetDiscoverMode BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the terminal discovered mode Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned value is BT_ERR_SETTING_FAIL.
GetDiscoverMode Get terminal current discovered status. BOOL GetDiscoverMode Parameters None Returned V alues Return TRUE if terminal can be discovered, otherwise return FALSE. Example if(GetDiscoverMode()) AfxMessageBox(_T("Discover mode is enable")); Else AfxMessageBox(_T(“Discover mode is disable”)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
SetSPPService Enable or disable Bluetooth serial port profile service. DWORD SetSPPService BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the serial port profile service mode Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_SETTING_FAIL, BT_ERR_REG_DEV_FAIL, BT_ERR_SPP_COM_FAIL.
GetSPPService Get terminal current serial port profile service status. BOOL GetSPPService Parameters None Returned V alues Return TRUE if SPP service is enable, otherwise return FALSE. Example if(GetSPPService()) AfxMessageBox(_T("SPP service is enable")); Else AfxMessageBox(_T(“SPP service is disable”)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
SetFTPService Enable or disable File Transfer Profile service. DWORD SetFTPService BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the File Transfer Profile service mode Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_SETTING_FAIL.
GetFTPService Get terminal current File Transfer Profiel service status. BOOL GetFTPService Parameters None Returned V alues Return TRUE if FTP service is enable, otherwise return FALSE. Example if(GetFTPService()) AfxMessageBox(_T("FTP service is enable")); Else AfxMessageBox(_T(“FTP service is disable”)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
SetFTPWriteable Enable or disable File Transfer Profile writable. DWORD SetFTPWriteable BOOL bWriteable Parameters bWriteable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the File Transfer Profile writeable mode Returned V alues Return E_FUNC_SUCCEED if the operation is successful. Example if(SetFTPWriteable(TRUE) != E_FUNC_SUCCEED) AfxMessageBox(_T("Set FTP writeable fail"));...
GetFTPWriteable Get terminal current File Transfer Profile writeable status. BOOL GetFTPWriteable Parameters None Returned V alues Return TRUE if FTP writeable is enable, otherwise return FALSE. Example if(GetFTPWriteable()) AfxMessageBox(_T("FTP service is writeable")); else AfxMessageBox(_T(“FTP service is diswriteable)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
SetFTPShareFolder Setup the File Transfer Profile share folder. DWORD SetFTPShareFolder WCHAR *strShareFolder Parameters strShareFolder [in] The folder for File Transfer Profile. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned value is E_FUNC_PAR_ERROR.
GetFTPShareFolder Get terminal current File Transfer Profile share folder. DWORD GetFTPShareFolder WCHAR *strShareFolder, *nFolderLen Parameters strShareFolder [out] The buffer to receive the share folder string nFolderLen [in/out] The strShareFolder buffer max size. If terminal current share folder length > nFolderLen, the nFolderLen receive current share folder length.
InitSearchBTDevice This function initiates search information. DWORD InitSearchBTDevice HANDLE *hLookup Parameters hLookup [out] Handle to be used when calling the FindNextBTDevice & EndSearchBTDevice function Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR., BT_ERR_DEVICE_ERROR.
FindNextBTDevice This function retrieves the results of an nearby Bluetooth device search. DWORD FindNextBTDevice HANDLE hLookup, LPTSTR szDeviceName, ULONGLONG *btAddress, nNameLen Parameters hLookup [in] Handle obtained from InitSearchBTDevice function szDeviceName [out] The buffer to receive the device name string btAddress [out] Receive the device address of 64-bit unsigned integer nNameLen [in] The szDeviceName buffer max size.
Page 65
dwRe = FindNextBTDevice(hLookup, szDeviceName, &btAddress, 256); if(dwRe == BT_ERR_DEVICE_ERROR) break; ………… wsprintf(szAddress, L"%04X%08X", GET_NAP(btAddress), GET_SAP(btAddress)); ………… EndSearchBTDevice(hLookup); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
EndSearchBTDevice This function frees the search handle. DWORD EndSearchBTDevice HANDLE hLookup Parameters hLookup [in] Handle obtained from InitSearchBTDevice function Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, BT_ERR_DEVICE_ERROR. Example DWORD dwRe;...
InitSearchFTPDevice Initial search Bluetooth device support File Transfer Profile service. DWORD InitSearchFTPDevice Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, BT_ERR_DEVICE_ERROR. Example DWORD dwPos, dwRe; WCHAR szDeviceName[128];...
FindFirstFTPDevice Get the first searched device position information after calling InitSearchFTPDevice(). DWORD FindFirstFTPDevice DWORD *dwPos, LPTSTR szDeviceName, ULONGLONG *btAddress, nNameLen Parameters dwPos [in/out] a reference to a position value returned by FindFirstBTDevice or FindNextBTDevice function szDeviceName [out] The buffer to receive the device name string btAddress [out] Receive the device address of 64-bit unsigned integer nNameLen...
Page 69
wsprintf(szAddress, L"%04X%08X", GET_NAP(btAddress), GET_SAP(btAddress)); ………… Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
FindNextFTPDevice Get the next searched device position information. DWORD FindNextFTPDevice DWORD *dwPos, LPTSTR szDeviceName, ULONGLONG *btAddress, nNameLen Parameters dwPos [in/out] a reference to a position value returned by FindFirstBTDevice or FindNextBTDevice function szDeviceName [out] The buffer to receive the device name string btAddress [out] Receive the device address of 64-bit unsigned integer nNameLen...
Page 71
wsprintf(szAddress, L"%04X%08X", GET_NAP(btAddress), GET_SAP(btAddress)); ………… Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
PairDevice Pair terminal with other device. DWORD PairDevice ULONGLONG btAddress unsigned char PinCode[16] Parameters btAddress [in] The device address for pair with PinCode [in] The pin code for connection Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_PAIR_FAIL, BT_ERR_DEVICE_ERROR.
UnPairDevice Unpair terminal with other device. DWORD UnPairDevice ULONGLONG btAddress Parameters btAddress [in] The device address for unpair Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned value is BT_ERR_DEVICE_ERROR. Example PairDevice(btAddress, PinCode);...
GetComInfo Get com identifier index and amount from device hardware. DWORD GetComInfo int *nComSum, LPCWSTR pComV alue, *nComV alueLen Parameters nComSum [out] Receive the device com amount pComV alue [out] The buffer to receive the device com identifier index nComV alueLen [in/out] The pComV alue buffer max size.
Page 75
Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
ConnectDevice Connect to Bluetooth device for SPP or FTP . DWORD ConnectDevice ULONGLONG btAddress, CONNECT_INFO *Info, BOOL nConnect Parameters btAddress [in] The device address for connect Info [in] The device connect information., see CONNECT_INFO data structure. nConnect [in] Connect status. 1 connect, 0 disconnect Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
GetConnectStatus Query the device connect status. DWORD GetConnectStatus ULONGLONG btAddress, int nConnectType, LPCWSTR pCom, *nStatus Parameters btAddress [in] Bluetooth device address nConnectType [in] Connect profile type. 1 Serial port profile, 2 File transfer profile pCom [in] The connect com for Serial port profile, must be four characters long.. Contains "COM"+ com identifier index, for example "COM7".
GetSPPClientChannel Get the device serial port profile channel. DWORD GetSPPClientChannel ULONGLONG btAddress, *nChannel Parameters btAddress [in] The device address which to get SPP channel nChannel [out] Receive queried channel Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, BT_ERR_DEVICE_ERROR.
FindFirstFTPFile Get first file information from share folder in the connected device. DWORD FindFirstFTPFile WCHAR *path, FTP_FILE *File Parameters path [in] The path of connected device for search file. File [out] The first searched file information in the path, see FTP_FILE data structure.
FindNextFTPFile Get next file information from share folder in the connected device. DWORD FindNextFTPFile FTP_FILE *File Parameters File [out] The received file information, see FTP_FILE data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT, BT_ERR_FTP_EMPTY_FILE.
GetFTPFile Get file from share folder in the connected device. DWORD GetFTPFile LPCWSTR pTargetFile Parameters pT argetFile [in] The file to get from connected device Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
PutFTPFile Send file to share folder in the connected device. DWORD PutFTPFile LPCWSTR pSourceFile, LPCWSTR pTargetPath Parameters pSourceFile [in] The source file in the share folder to transfer to connected device. pT argetPath [in] The target path in the connected device to save file. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
CreateFTPFolder Create a new folder to share folder in the connected device. DWORD CreateFTPFolder LPCWSTR pTarget Parameters pT arget [in] The folder which be created to share folder in the connected device Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
DeleteFTPFolder Delete folder from share folder in connected device. DWORD DeleteFTPFolder LPCWSTR pTarget Parameters pT arget [in] The folder will be deleted from share folder in the connected device Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
DeleteFTPFile Delete file from share folder in connected device. DWORD DeleteFTPFile LPCWSTR pTarget Parameters pT arget [in] The file will be deleted from share folder in the connected device. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
Camera Related Function Camera_On To ENABLE the Camera function and initial. DWORD Camera_On HWND hVideoWnd Parameters hVideoWnd [in] The handle of new owner window. This parameter can set NULL. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are CAM_ERR_CREA TE_FAIL, CAM_ERR_VERSION_ERROR, CAM_ERR_GET_DEVICE_FAIL, CAM_ERR_VIDEO_WINDOW_FAIL, CAM_ERR_STILL_SETTING_FAIL.
Camera_Off To DISABLE the Camera function and release. void Camera_Off Parameters None. Returned V alues None Example BT_Off(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
SetPreviewSize To set the x-axis coordinate、y-axis coordinate、 width、height of the preview window. DWORD SetPreviewSize UINT uiPosX UINT uiPosY UINT uiWidth UINT uiHeight Parameters uiPosX [in] Specifies the x-axis coordinate to be set. Range: 0~240. uiPosY [in] Specifies the y-axis coordinate to be set. Range: 0~320. uiWidth [in] Specifies the width to be set.
GetPreviewSize To get the x-axis coordinate、y-axis coordinate、width、height of the preview window. DWORD GetPreviewSize UINT *uiPosX UINT *uiPosY UINT *uiWidth UINT *uiHeight Parameters uiPosX [out] Specifies the x-axis coordinate to be retrieved. uiPosY [out] Specifies the y-axis coordinate to be retrieved. uiWidth [out] Specifies the width to be retrieved.
EnablePreview Change to ENABLE or DISABLE of the preview window. DWORD EnablePreview BOOL bEnable Parameters bEnable [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) preview window. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, CAM_ERR_DEVICE_ERROR.
SetStillCaptureSize To set the image pixel for still picture capture. DWORD SetStillCaptureSize DWORD dwImageSize Parameters dwImageSize [in] Flags for setting image pixel. This parameterer must be one of the values in the table below. Value Image pixel QSXGA (2560*1944) SXGA (1280*960) Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
GetStillCaptureSize To get the image pixel setting value for still picture capture. DWORD GetStillCaptureSize DWORD *dwImageSize Parameters dwImageSize [out] Receive the image pixel setting value. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, CAM_ERR_DEVICE_ERROR.
StartStillCapture To Start with still picture capture and save to file path. DWORD StartStillCapture LPTSTR lpPathName BOOL bSound Parameters lpPathName [in] Pointer to the file save path after capture still picture. Max size of 256. bSound [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) shutter sound. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
SetFlash To set ENABLE or DISABLE the flash light. DWORD SetFlash BOOL bEnable Parameters bEnable [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) flash light. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
GetFlash To get the flash light setting value. BOOL GetFlash Parameters None. Returned V alues Return TRUE if flash light is enable, otherwise return FALSE Example if(GetFlash () != TRUE) AfxMessageBox(_T("Flash is disable)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
SetDarkMode To set ENABLE or DISABLE the dark mode DWORD SetDarkMode BOOL bEnable Parameters bEnable [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) dark mode. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
GetDarkMode To get the dark mode setting value. BOOL GetDarkMode Parameters None. Returned V alues Return TRUE if dark mode is enable, otherwise return FALSE Example if(GetDarkMode() != TRUE) AfxMessageBox(_T("Dark mode is disable)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
SetInvert To set the media stream invert, include flip、mirror. DWORD SetInvert BOOL bFlip BOOL bMirror Parameters bFlip [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) media stream invert of upside down. bMirror [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) media stream invert of left to right.
GetInvert To get the media stream invert setting value, include flip、mirror.. DWORD GetInvert BOOL *bFlip BOOL *bMirror Parameters bFlip [out] Receive the media stream flip setting value. bMirror [out] Receive the media stream mirror setting value. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR.
GPRS Related Function GPRS_On To ENABLE the GPRS function and initial. DWORD GPRS_On Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are GPRS_ERR_CREA TE_FAIL, GPRS_ERR_VERSION_ERROR. Example if(GPRS_On(NULL) != E_FUNC_SUCCEED) AfxMessageBox(_T("GPRS on fail"));...
GPRS_Off To DISABLE the GPRS function and release. void GPRS_Off Parameters None. Returned V alues None Example GPRS_Off(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
GetGPRSPowerStatus Get current power status of GPRS module. BOOL GetGPRSPowerStatus BOOL *bStatus Parameters bStatus [out] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) GPRS power. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Example BOOL bStatus; if(GetGPRSPowerStatus(&bStatus) != TRUE) AfxMessageBox(_T("Get GPRS power status fail!"));...
SendATCommand Send specify A T command and verify required response. DWORD SendATCommand char *lpCmd, char *lpResponse, DWORD dwResLen, DWORD dwWaitTime Parameters lpCmd [in] Specifies A T command. Max size of 256. lpResponse [out] Receive the required response data. dwResLen [in] The lpResponse buffer max size. dwW aitTime [in] The time interval for wait response, in milliseconds.
GetATResponse Get response data from module buffer. DWORD GetATResponse char *lpResponse, DWORD dwResLen, DWORD dwWaitTime Parameters lpResponse [out] Receive the response data. dwResLen [in] The lpResponse buffer max size. dwW aitTime [in] The time interval for wait response, in milliseconds. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
GetIMEINumber Get module International Mobile Equipment Identity (IMEI) number. DWORD GetIMEINumber LPTSTR lpIMEI Parameters lpResponse [out] Receive the module IMEI number. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
GetIMSINumber Get SIM card International Mobile Subscriber Identity (IMSI) number. DWORD GetIMSINumber LPTSTR lpIMSI Parameters lpIMSI [out] Receive the SIM card IMSI number. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
GetModuleInfo Get module identification information, include manufacture、module、revision. DWORD GetATResponse LPTSTR lpManufacture, LPTSTR lpModule, LPTSTR lpRevision Parameters lpManufacture [out] Receive the manufacture identification. lpModule [out] Receive the product model identification. lpRevision [out] Receive the firmware version identification. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
GetSignalQuality Get signal strength from the module to the GSM/GPRS network. DWORD GetSignalQuality DWORD *dwQuality Parameters dwQuality [out] Receive the signal strength.of GSM/GPRS network. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
ConnectRAS Establishes a RAS connection. Supports callback information. DWORD ConnectRAS LPTSTR lpEntryName, HWND hNotifyWnd Parameters lpEntryName [in] The entry name to use to establishes the connect. hNotifyWnd [in] Pointer to a window handles to receive RasDial event notifications (for WinCE is WM_RASDIALEVENT).
DisconnectRAS Disconnect current RAS connection. DWORD DisconnectRAS Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR. Example if(DisconnectRAS() != E_FUNC_SUCCEED) AfxMessageBox(_T("Disconnect RAS fail!")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
GetRASConnStatus Get status from the RAS connection opened with ConnectRAS. DWORD GetRASConnStatus DWORD *dwStatus Parameters dwStatus [out] Receive the current status of the specified RAS connection. Value Connect Status Disconnection or failed connection Successfully established connection Other connect status Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
CreateRASEntry Create a new RAS entry. DWORD CreateRASEvtry LPTSTR lpEntryName, RAS_ENTRY *Entry Parameters lpEntryName [in] The RAS entry name of an new entry to be create. Entry [in] The connect entry information, see RAS_ENTRY data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_ENTRY_ALREADY_EXIST, GPRS_ERR_ENTRY_NOT_EXIST.
DeleteRASEntry Delete a RAS entry. DWORD DeleteRASEntry LPTSTR lpEntryName Parameters lpEntryName [in] The RAS entry name of an existing entry to be deleted. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
ChangeRASEntryName Change the name of a RAS entry. DWORD ChangeRASEntryName LPTSTR lpOldEntry, LPTSTR lpNewEntry Parameters lpOldEntry [in] The old RAS entry name of an existing entry. lpNewEntry [in] The new RAS entry name of an not exist entry. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
ChangeRASEntryProperty Change the property of a RAS entry. DWORD ChangeRASEvtryProperty LPTSTR lpEntryName, RAS_ENTRY *Entry Parameters lpEntryName [in] The RAS entry name of an existing entry to be change. Entry [in] The connect entry information, see RAS_ENTRY data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
GetRASEntryProperty Get the property of a RAS entry. DWORD GetRASEvtryProperty LPTSTR lpEntryName, RAS_ENTRY *Entry Parameters lpEntryName [in] The RAS entry name of an existing entry to be get information. Entry [out] Receive the connect entry information, see RAS_ENTRY data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
GetRASEntryCount Get entry count for RAS connection. DWORD GetRASEntryCount *nCount Parameters nCount [out] Receive the RAS entry count. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR. Example int iCount;...
MenuRASEntries Menu all existing RAS entries, and get specified entry name. DWORD MenuRASEntries int nIndex, LPTSTR lpEntryName Parameters nIndex [in] The zero-based index of a RAS entry. lpEntryName [out] Receive the specified RAS entry name. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
GetPINCounter Get count of attempts still available for entering the currently required password, for example the PIN、PUK… DWORD GetPINCounter *nCount Parameters nCount [out] Receive the number of attempts still available. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
GetPINStatus Get the current authentication code status of SIM card DWORD GetPINStatust DWORD *dwStatus Parameters dwStatus [out] Receive the authentication code status. The return value can be one of the values in the following table. Value Authentication Code Status "ERROR", SIM card maybe not exist "READY", PIN has already been entered "SIM PIN", wait SIM PIN enter "SIM PUK", wait SIM PUK enter...
SetPINLock Set PIN code lock or unlock. DWORD SetPINLock LPTSTR lpPIN, BOOL bLock Parameters lpPIN [in] PIN code passwords, size of 4~8 character. bLock [in] Flag that indicates whether to lock (TRUE) or unlock(FALSE) the PIN code. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
Page 122
GetPINLockStatus Get the PIN code lock status of SIM card DWORD GetPINLockStatus BOOL *bStatus Parameters bStatus [out] Receive the PIN code lock status. TRUE indicates lock is active, FALSE indicates lock is inactive. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 123
CheckPINCode Enter PIN code passwords, and check correctness. DWORD GheckPINCode LPTSTR lpPIN, BOOL *bMatch Parameters lpPIN [in] PIN code passwords, size of 4~8 character. bMatch [out] Receive the check result. TRUE indicates passwords is ok, FALSE indicates passwords is error. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
Page 124
CheckPUKCode Enter PUK code passwords, and check correctness. DWORD CheckPUKCode LPTSTR lpPUK, LPTSTR lpNewPIN, BOOL *bMatch Parameters lpPUK [in] PUK code passwords, size of 8 character. lpNewPIN [in] New PIN code passwords, size of 4~8 character. bMatch [out] Receive the check result. TRUE indicates passwords is ok, FALSE indicates passwords is error. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
Page 125
ChangePINCode Allows defining new PIN code password. DWORD ChangePINCode LPTSTR lpOldPIN, LPTSTR lpNewPIN Parameters lpOldPIN [in] Old PIN code passwords, size of 4~8 character. lpNewPIN [in] New PIN code passwords, size of 4~8 character. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 126
ReadPhonebook Read a phonebook entry in SIM card. DWORD ReadPhonebook int nIndex, LPTSTR lpNumber, LPTSTR lpName Parameters nIndex [in] The one-based index of a phonebook entry. lpNumber [out] Receive the phonebook entry number lpName [out] Receive the phonebook entry text. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
Page 127
WritePhonebook Write a phonebook entry in SIM card. DWORD WritePhonebook int nIndex, LPTSTR lpNumber, LPTSTR lpName, nNumType Parameters nIndex [in] The one-based index of a phonebook entry. If this parameter is 0, the phonebook entry wills automatic write empty location. lpNumber [in] Phonebook entry number lpName...
Page 128
DeletePhonebook Delete a phonebook entry in SIM card. DWORD DeletePhonebook nIndex Parameters nIndex [in] The one-based index of a phonebook entry. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 129
ReadMultiPhonebook Read multitude phonebook entries in SIM card. DWORD ReadMultiPhonebook int nStartIndex, int nEndIndex, DWORD *dwResLen, PHONEBOOK_INFO *Info, DWORD *dwInfoLen, *nCount Parameters within nStartInde [in] The first location number to start reading, one-based index. nEndIndex [in] The last location number to stop reading, one-based index. dwResLen [in/out] The response buffer max size.
Page 131
GetPhonebookTotal Get amount of phonebook entry in SIM card, include used、total. DWORD GetPhonebookTotal int *nUsed, *nTotal Parameters nUsed [out] Receive the amount of used. nT otal [out] Receive the amount of allow maximum. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 132
GetPhoneMaxLength Get maximum length of number field and text field by SIM card. DWORD GetPhoneMaxLength int *nNumberLen, *nNameLen Parameters nNumberLen [out] Receive the maximum length of phone number. nNameLen [out] Receive the maximum length of phone text. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
Page 133
SendSMS Send SMS message to specified phone number. DWORD SendSMS LPTSTR lpCenterNum, LPTSTR lpSendNum, LPTSTR lpData Parameters lpCenterNum [in] The phone number of short message service center (SMSC), max size of 30. If this parameter is NULL, will use storage SMSC in terminal to send. lpSendNum [in] The phone number of recipient, max size of 30.
Page 134
ReadSMS Read a SMS message in SIM card. DWORD ReadSMS int nIndex, int *nStatus, LPTSTR lpNumber, LPTSTR lpData, LPTSTR lpTimeStamp Parameters nIndex [in] The one-based index of a SMS message. nStatus [out] Receive the message status. The return value can be one of the values in the following table. Value Message Status "REC UNREAD", received unread message...
Page 135
Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Page 136
DeleteSMS Delete a SMS message in SIM card. DWORD DeleteSMS nIndex Parameters nIndex [in] The one-based index of a SMS message. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 137
ReadMultiSMS Read multitude SMS messages in SIM card. DWORD ReadMultiSMS int nStatus, DWORD *dwResLen, SMS_INFO *Info, DWORD *dwInfoLen, *nCount Parameters nStatus [in] The message status can be one of the values in the following table. Value Message Status "REC UNREAD", received unread messages "REC READ", received read messages "STO UNSENT", stored unsent messages "STO SENT", stored sent messages...
Page 139
WriteStorageSMS Write a SMS message to SIM memory storage. DWORD WriteStorageSMS int *nIndex, LPTSTR lpCenterNum, LPTSTR lpSendNum, LPTSTR lpData Parameters nIndex [out] Receive the one-based index of storage SMS message. lpCenterNum [in] The phone number of short message service center (SMSC) , max size of 30. If this parameter is NULL, will use storage SMSC in terminal to send.
Page 140
SendStorageSMS Send a SMS message from SIM memory storage. DWORD SendStorageSMS nIndex Parameters nIndex [in] The one-based index of storage SMS message. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 141
GetSMSTotal Get amount of SMS message in SIM card, include used、total. DWORD GetSMSTotal int *nUsed, *nTotal Parameters nUsed [out] Receive the amount of used. nT otal [out] Receive the amount of allow maximum. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 142
SetSMSCentre Set phone number of short message service center (SMSC). DWORD SetSMSCentre LPTSTR lpNumber Parameters lpNumber [in] SMS centre phone number. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 143
GetSMSCentre Get phone number of short message service center (SMSC). DWORD GetSMSCentre LPTSTR lpNumber, nMaxLen Parameters lpNumber [out] Receive the SMS centre phone number. nMaxLen [in] The lpNumber buffer max size. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
Page 144
SMS_Register To register the SMS application to SYSAPIAX.dll so that SYSAPIAX.dll can communicate with the application. DWORD SMS_Register HWND hNotifyWnd, UINT uNewSMSNotify, UINT uNewPhoneNotify Parameters hNotifyWnd [in] The window handling the function library will send message to report. uNewSMSNotify [in] Application-defined message identifier. The system uses this for notification message that it sends to the window identified in hNotifyWnd.
Page 145
SMS_UnRegister To unregister the SMS application from SYSAPIAX.dll. DWORD SMS_UnRegister Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR. Example if(SMS_UnRegister() != E_FUNC_SUCCEED) AfxMessageBox(_T("SMS_UnRegister fail!")); Requirements OS V ersions: Windows CE 6.0 or beyond.
Page 146
The GPS receiver on the PT90 uses COM8 to output NMEA messages, when the COM port is opened. Using Microsoft Standard API to open serial port and receive NMEA data. For details, please refer to NMEA 0183 ver3.0. Serial Configuration GPS receiver Com port Baud rate...
Page 147
Bluetooth Structure CONNECT_INFO Structure This setting file contains information used by ConnectDevice Struct CONNECT_INFO int nChannel; int nConnectType; WCHAR strCom[6]; Members nChannel The connect channel for Serial port profile nCannectType Connect profile type. 1 Serial port profile, 2 File transfer profile strCom The connect com for Serial port profile, must be four characters long..
Page 148
FTP_FILE Structure This setting file contains information used by FindFirstFTPFile, FindNextFTPFile Struct FTP_FILE int nFileType; WCHAR strPath[260]; WCHAR strFile[260]; DWORD dwFileSize; Members nFileType File object profile type. 0 File, 1 Folder strPath The file path strFile The file name; It will be null if the object is a folder dwFileSize The file size , in bytes;...
Page 149
GPRS Structure RAS_ENTRY Structure This setting file contains information used by CreateRASEntry, ChangeRASEntryProperty, GetRASEntryProperty. Struct CONNECT_INFO DWORD dwCountryCode; WCHAR szAreaCode[10]; WCHAR szPhoneNumber[128]; WCHAR szExtraCmd[330]; WCHAR szUserName[256]; WCHAR szPassword[256]; WCHAR szDomain[15]; Members dwCountryCode Specifies the country/region code portion of the phone number. szAreaCode Null.-terminated string that contains the area code.
Page 150
Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Page 151
PHONEBOOK_INFO Structure This setting file contains information used by ReadMultiPhonebook. Struct PHONEBOOK_INFO DWORD dwSize; int nIndex; WCHAR szNumber[30]; WCHAR szName[30]; Members dwSize Specifies the structure size, in bytes. nIndex The one-based index of a phonebook entry. szNumber Phonebook entry number. szName Phonebook entry text.
Page 152
SMS_INFO Structure This setting file contains information used by ReadMultiSMS. Struct SMS_INFO DWORD dwSize; int nIndex; int nStatus; WCHAR szNumber[30]; WCHAR szData[160]; WCHAR szTimeStamp[30]; Members dwSize Specifies the structure size, in bytes. nIndex The one-based index of a SMS message. nStatus Message status.
RFID.DLL We supply RFID.DLL which includes several functions to allow programmer to control the on-board RFID device. Programmer can use WINCE develop tool like Visual Studio 2005 to develop application programs. Descriptions of all these functions are given below. RFID Related Functions ...
Page 154
When user wants to use this library, user should link RFID.DLL, RFID.LIB and the relate functions header file (RFID.H). PT-90 Mobile Computer SDK Programming Manual...
RFID Related Function OpenComPort Open com port to connect the RFID module. int OpenComPort iCom Parameters iCom [in] The RFID module com port number. PT90 only specified com 6. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example if(OpenComPort(6) != 0) AfxMessageBox(_T("RFID open com fail"));...
CloseComPort Close com port and disconnect the RFID module connection. int CloseComPort Parameters None. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example if(CloseComPort() != 0) AfxMessageBox(_T("RFID close com fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: RFID.h Link Library: RFID.lib Link DLL: RFID.dll...
GetFWVersion Get RFID module firmware version. int GetFWV ersion char lpOutV ersion[] Parameters lpOutV ersion [out] Receive the RFID module firmware version. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example char cV ersion[20]; if(GetFWV ersion(cV ersion) != 0) AfxMessageBox(_T("Get FW version fail"));...
APIVersion Get RFID API version. int APIV ersion char lpOutV ersion[] Parameters lpOutV ersion [out] Receive the RFID API version. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example char cV ersion[20]; if(APIV ersion(cV ersion) != 0) AfxMessageBox(_T("Get API version fail"));...
SetWorkingType Set RFID module working type with different tag type, and this function should be called before read card. int SetWorkingType int iType, iHalfPower Parameters iType [in] The RFID module working type. This parameter must be one of the values in the table below. Value Working type 15693...
AntennaContro Enable/Disable antenna to save power. int AntennaContro iSelect Parameters iSelect [in] Flag that indicates whether to Enable(1) or Disable(0) the antenna. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example if(AntennaContro(1) != 0) AfxMessageBox(_T("Antenna control fail")); Requirements OS V ersions: Windows CE 6.0 or beyond.
Inventory15693 Get ISO 15693 tag unique identifier (UID). int Inventory15693 char lpFlag[], char lpAFI[], char lpOutUID[] Parameters lpFlag [in] Set request flag, please refer to table below. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3...
ReadSingleBlock Read data of single block from ISO 15693 tag. int ReadSingleBlock int iBlock, char lpFlag[], char lpAddressUID[], char lpOutData[] Parameters iBlock [in] The block index of ISO 15693 tag. Please refer to tag respective document. lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags.
WriteSingleBlock Write data of single block to ISO 15693 tag. int WriteSingleBlock int iBlock, char lpFlag[], char lpAddressUID[], char lpData[] Parameters iBlock [in] The block index of ISO 15693 tag. Please refer to tag respective document. lpFlag [in] Set request flag, please refer to table below and RFID Request Flags.
WriteAFI Write application family identifier (AFI) to ISO 15693 tag. int WriteAFI char lpFlag[], char lpAddressUID[], char lpData[] Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6...
WriteDSFID Write data structure format identifier (DSFID) to ISO 15693 tag. int WriteDSFID char lpFlag[], char lpAddressUID[], char lpData[] Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6...
LockAFI Lock application family identifier (AFI) on ISO 15693 tag. int LockAFI char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5...
LockDSFID Lock data structure format identifier (DSFID) on ISO 15693 tag. int LockDSFID char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5...
LockBlock Lock specific block on ISO 15693 tag. int LockBlock int iBlock, char lpFlag[], char lpAddressUID[], Parameters iBlock [in] The block index of ISO 15693 tag. Please refer to tag respective document. lpFlag [in] Set request flag, please refer to table below and RFID Request Flags.
TagSystemInfo Get tag information from ISO 15693 tag. int TagSystemInfo char lpFlag[], char lpAddressUID[], char lpOutData[] Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4...
TagStayQuiet Set ISO 15693 tag to stay quiet state. int TagStayQuiet char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4...
TagSelect Set ISO 15693 tag to select state. int TagSelect char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3...
TagResetToReady Set select or ouiet tag to ready state. int TagResetToReady char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4...
OpenCard14443A Open ISO 14443A tag of mifare type and get the tag UID. int OpenCard14443A char lpOutUID[], char lpOutType[] Parameters lpOutUID [out] Receive the tag unique identifier. lpOutData [out] Receive the tag type. Please refer to mifare based document For example common values in the following table.
ReadMifareBlock Read data of single block from ISO 14443A mifare S50/S70 tag. int ReadMifareBlock int iKeyType, char lpKey[], int iBlock, char lpOutData[] Parameters iKeyType [in] The key type. This parameter must be one of the values in the table below. Value Key type Key A...
WriteMifareBlock Write data of single block to ISO 14443A mifare S50/S70 tag. int WriteMifareBlock int iKeyType, char lpKey[], int iBlock, char lpData[] Parameters iKeyType [in] The key type. This parameter must be one of the values in the table below. Value Key type Key A...
ReadUltraLightBlock Read data of single block from ISO 14443A mifare ultralight tag. int ReadUltraLightBlock int iBlock, char lpOutData[] Parameters iBlock [in] The block index of mifare ultralight tag. Please refer to tag respective document. lpOutData [out] Receive the block data. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
WriteUltraLightBlock Write data of single block to ISO 14443A mifare ultralight tag. int WriteUltraLightBlock int iBlock, char lpData[] Parameters iBlock [in] The block index of mifare ultralight tag. Please refer to tag respective document. lpData [in] The block data, 8byte. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
GetUid14443B Get ISO 14443B tag UID. int GetUid14443B int iType, char lpOutUID[] Parameters iType [in] The tag type. This parameter must be one of the values in the table below. Value Key type 14443B SR176 SRIX4K lpOutUID [out] Receive the tag unique identifier. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
SRIX4KChipID Get ISO 14443B SRIX4K tag chip ID. int SRIX4KChipID char lpOutID[] Parameters lpOutData [out] Receive the tag chip ID. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example char cID[4]; if(SRIX4KChipID(cID) != 0) AfxMessageBox(_T("Get SRIX4K chip ID fail")); Requirements OS V ersions: Windows CE 6.0 or beyond.
SRIX4KReadBlock Read data of single block from ISO 14443B SRIX4K tag. int SRIX4KReadBlock int iBlock, char lpOutData[] Parameters iBlock [in] The block index of SRIX4K tag. Please refer to tag respective document. lpOutData [out] Receive the block data. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
SRIX4KWriteBlock Write data of single block to ISO 14443B SRIX4K tag. int SRIX4KWriteBlock int iBlock, char lpData[] Parameters iBlock [in] The block index of SRIX4K tag. Please refer to tag respective document. lpOutData [in] The block data, 8byte. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
RFID Request Flags Flag Name Value Description Request executed by any tag according to the setting of Address flag. Bit 5 Select_flag Request executed only by tag in selected state. The Address flag is set to 0 and the UID field is not included in the request. Request is not addressed.
SRIX4K Flow Chart RFID module on SetWorkingType(3,0) SRIX4KChipID() GetUid14443B() SRIX4KReadBlock() SRIX4KWriteBlock() Remove tag of RFID field PT-90 Mobile Computer SDK Programming Manual...
SCANAPIAX.DLL We supply SCANAPIAX.DLL to allow programmer to control the on-board scanning device. There are several functions available for programmer to tailor the application. Programmer can also use Windows CE development tool, such as Visual Studio 2005, to develop application program and control the on-board scanning device.
Page 185
SCAN_BatchSetting – Setup scanner in batch command. SCAN_BatchRead – Read scanner settings in batch command. Scan2Key Related Functions Programmer can use Scan2Key related functions to control scan.exe program. When scan.exe is loaded, scanned data will be sent to key buffer. Target application program can retrieve scanned data just like standard keyboard input.
Page 186
EAN8_Setting Structure – Information of EAN8 settings. EAN13_Setting Structure – Information of EAN13 settings. Industrial25_Setting Structure – Information of Industrial 2 of 5 settings. Interleaved25_Setting Structure –Information of Interleaved 2 of 5 settings. MSI_Setting Structure –...
API_SCAN Related Functions API_Register To Register the target application to SCANAPIAX.dll so that SCANAPIAX.dll can communicate with the application. It will also set the scanning device to working mode. BOOL API_Register HWND hwnd Parameters hwnd [in] the window handling the function library will send message to report all activities of the scanning device.
API_Unregister To Unregister the target application from SCANAPIAX.dll and close the scanning device. void API_Unregister Parameters None Return V alues None. Example API_Unregister(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
API_GetBarData To Get Barcode into the buffer. When receiving the message SM_DA TA_READY , call this function can get the barcode data. UINT API_GetBarData LPBYTE buffer, UINT * uiLength, UINT * uiBarType Parameters buffer [out] buffer for scanned data string. uiLength [in/out] buffer size uiBarType...
Page 190
strBarType.Format(_T("%d"), uiType); for(i = 0 ; i < strlen(pBuf); i++) strBarData += *(pBuf+i); AfxMessageBox( _T("Type:") + strBarType + _T("\r\nBarcode:") + strBarData); return 0; Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
API_GetBarDataLength To Get Length of the scanned data UINT API_GetBarDataLength Parameters None Returned V alues Length of the scanned data Example if(message == SM_DA TA_READY){ CString strData; UINT uiSize, uiType, i,uiLength; char *pBuf; uiLength = API_GetBarDataLength(); if(uiLength == 0) strData = _T("No Data"); else{ uiSize = uiLength+1;...
API_GetBarType To Get the barcode type. UINT API_GetBarType Parameters None Returned V alues Always return zero Remarks value Barcode value Barcode BC_CODE11(100) Code 11 BC_UK_PLESSEY(111) UK Plessey BC_CODE39(101) Code 39 BC_TELEPEN(112) Telepen BC_CODE93(102) Code 93 BC_UPCA(113) UPCA BC_CODE128(103) Code 128 BC_UPCE(114) UPCE BC_CODABAR(104)
API_GetError To Get the error code. DWORD API_GetError Parameters None Returned V alues The returned value can be one of those in the table below: Constant Value Description ERR_WRITE_FAIL WM_USER+1 Send commands to scanner module failed. ERR_SETTING_FAIL WM_USER+2 Set scanner setting failed. ERR_SCANNER_NOT_OPEN WM_USER+3 Open scanner module failed.
API_GetSysError To Get the system error code. DWORD API_GetSysError Parameters None Returned V alues Returning the system error code that is returned by GetLastError(). Descriptions of system error code can be found in MSDN. Example dwError = API_GetSysError(); strMess.Format(_T("System Error Code: %d"), dwError); AfxMessageBox(strMess);...
API_GoodRead To activate a buzzer sound when the buzzer of the scanning device is enabled and to flash the LED when the good-read LED of the scanning device is enabled. void API_GoodRead Parameters None Returned V alues None. Remarks Use API_GoodRead() to notify the user that a barcode data is successfully scanned. The buzzer function of the scanning device can be set by Scan Configuration in the control panel.
API_Reset To Reset the scanner settings to default. BOOL API_Reset Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example if(API_Reset()) AfxMessageBox(_T("Reset Succeed")); else AfxMessageBox(_T("Reset Fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
API_ResetBarData To Clear the data buffer to allow the next scanned data coming in. void API_ResetBarData Parameters None ReturnedV alues None. Example API_ResetBarData(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
API_SaveSettingsToFile To Save current scanner settings to file. The extension file name is “axs”. BOOL API_SaveSettingsToFile LPCTSTR filename Parameters filename [in] file name of the scanner settings. Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example CString strFile;...
API_SaveSettingsToScanner To Write current scanner settings into the scanner. BOOL API_SaveSettingsToScanner Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example if(API_SaveSettingsToScanner()) AfxMessageBox(_T("Save to Scanner Succeed")); else AfxMessageBox(_T("Save to Scannere Fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
S2K_IsLoad To Check if the application program scan.exe(scan barcode and send the scanned data into key buffer) is executing. BOOL S2K_IsLoad Parameters None Returned V alues The returned value TRUE indicates that scan.exe is running. The returned value FALSE indicates that scan.exe is not running.
S2K_Load To Load or Unload the the application program scan.exe. BOOL S2K_Load BOOL bLoad, DWORD dwTimeOut Parameters bLoad [in] To set TRUE to Load scan.exe and FALSE to Unload scan.exe dwTimeOut [in] When Unload scan.exe it will wait until the scan.exe been closed or Timeout by this parameter. Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE.
SCAN_QueryStatus To Query current scanner settings. BOOL SCAN_QueryStatus int nCommand1, int nCommand2, char *pReturn Parameters nCommand1 [in] See scan command table. nCommand2 [in] See scan command table. pReturn [out] the current scanner settings. This buffer size must be larger than 100. ReturnedV alues Returning TRUE if the operation is successful, otherwise, return FALSE.
SCAN_SendCommand To Send scanner command to change the scanner status. BOOL SCAN_SendCommand int nCommand1, int nCommand2, char *pV alue Parameters nCommand1 [in] See scan command table. nCommand2 [in] See scan command table. pV alue [in] See scan command table. Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE.
SCAN_ResumeSystem To Enable/Disable scan key to resume system DWORD SCAN_ResumeSystem BOOL Parameters [in] Flag that indicates whether to Enable(TRUE) scan key to resume system or Disable(FALSE) scan key to resume system. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, E_FUNC_SCANNER_NOT_OPEN.
SCAN_BatchSetting To Setup all scanner settings in batch command DWORD SCAN_BatchSetting ScannerSetting setting Parameters setting [in] The ScannerSetting data structure. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED.. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, E_FUNC_SCANNER_NOT_OPEN, E_FUNC_SETTING_FAIL.
SCAN_BatchRead To Read all scanner settings in batch command DWORD SCAN_BatcRead ScannerSetting *setting Parameters setting [out] Pointer to ScannerSetting data structure. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_SCANNER_NOT_OPEN, E_FUNC_PAR_ERROR.
Scan2Key Related Functions PT_OpenScan2Key To Execute scan.exe to scan barcode and send the scanned data into terminal key buffer. BOOL PT_OpenScan2Key Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example BOOL bResult; bResult = PT_OpenScan2Key(); if(!bResult) AfxMessageBox(_T("PT_OpenScan2Key fail"));...
PT_CloseScan2Key To Close application program scan.exe. void PT_CloseScan2Key Parameters None Returned V alues None. Example PT_CloseScan2Key() Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
PT_SetToDefault To Reset all the scanner settings to default value. int PT_SetToDefault Parameters None Returned V alues Returning 1 if the operation is successful, otherwise, return 0. Example if(!PT_SetToDefault()) AfxMessageBox(_T("PT_SetToDefault fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
Scanner Related Functions PT_EnableScanner To Enable scanner to scan barcode. This function will also get scanned data from scanning device and store in the system buffer. Application can use the other function, PT_GetBarcodeData , to retrieve scanned data from system buffer. int PT_EnableScanner Parameters None...
PT_DisableScanner To close the scanning device. void PT_DisableScanner Parameters None Returned V alues None. Example PT_DisableScanner(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
PT_CheckBarcodeData To Check whether there is scanned barcode data available in system buffer. BOOL PT_CheckBarcodeData Parameters None Returned V alues This function returns TRUE if there is scanned barcode data in system buffer and FALSE if there is no scanned barcode data in system buffer.
PT_GetBarcodeData To Get Barcode data and barcode type from system buffer. BOOL PT_GetBarcodeData UINT * uiBarType, Char * pBuffer, UINT * uiMaxBufferLen Parameters uiBarType [out] barcode type. pBuffer [out] buffer for storing scanned data.. uiMaxBufferLen [in/out] The maximum buffer size Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE.
Page 215
Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
PT_SetDefault To Reset the scanner settings to default. BOOL PT_SetDefault Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example if(PT_SetDefault()) AfxMessageBox(_T("PT_SetDefault succeed")); else AfxMessageBox(_T("PT_SetDefault fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
Scan Key Related Functions EnableTriggerKey To Enable or Disable the scan Trigger Key. DWORD EnableTriggerKey BOOL bEnable Parameters bEnable [in] Flag that indicates whether to Enable(TRUE) or Disable(FALSE) the scan Trigger Key. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
GetLibraryVersion To Get Library V ersion information. int GetLibraryV ersion Parameters None Returned V alues The version information, for example, if the returned value is 301, it means that dll version is 3.01 Example int nV ersion; CString strTemp; nV ersion = GetLibraryV ersion(); strTemp.Format(_T("V ersion = %d"), nV ersion);...
GetTriggerKeyStatus To Get scan Trigger Key Status. DWORD GetTriggerKeyStatus Parameters None. Returned V alues Returned value 1 indicates that the scan Trigger Key is enabled. Returned value 0 indicates that the scan Trigger Key is disabled. Example if(GetTriggerKeyStatus()) AfxMessageBox(_T("scan key ensable!")); else AfxMessageBox(_T("scan key disable!"));...
PressTriggerKey ToTrigger the Scan Key. DWORD PressTriggerKey BOOL bPress Parameters bPress [in] Flag that indicates whether to Press(TRUE) or Release(FALSE) the scan Trigger Key. Returned V alues If this action succeeds, the returnedvalue is E_FUNC_SUCCEED. If this action fails, the returned value is E_FUNC_ERROR.
TriggerStatus To get the scan Trigger Key status. DWORD TriggerStatus Parameters None. Returned V alues The returned value 1 indicates that the scan Trigger Key is pressed and 0 indicates that scan Trigger Key is released. Example if(TriggerStatus()) AfxMessageBox(_T("scan key pressed!")); else AfxMessageBox(_T("scan key release!"));...
Page 224
Remarks The cbSize must be the size of Structure ScannerSetting, in bytes. Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Code11_Setting Structure This setting contains information used by Structure ScannerSetting. Struct Code11_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members Code11 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Code93_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Code93_Setting UINT m_uiRead; UINT m_uiCodeID; Members All members Code93 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Code128_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Code128_Setting UINT m_uiRead; UINT m_uiCodeID; UINT m_uiUCCEAN128; UINT m_uiISBT128; UINT m_uiISBT128XmitID; UINT m_uiISBT128Concat; UINT m_uiISBT128Form; Members All members Code128 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Codabar_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Codabar_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiXmitStarStop; UINT m_uiDualField; Members All members Codabar settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
EAN8_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct EAN8_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiConvertToEAN13; Members All members EAN8 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
EAN13_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct EAN13_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiISBNConvert; UINT m_uiISBNSuppReq; UINT m_uiISMNConvert; UINT m_uiISMNSuppReq; Members All members EAN13 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Industrial25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Industrial25_Setting UINT m_uiRead; UINT m_uiCodeID; Members All members Industrial 2 of 5 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Interleaved25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Interleaved25_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members Interleaved 2 of 5 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
MSI_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct MSI_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members MSI Plessey settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
UK_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UK_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members UK Plessey settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Telepen_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Telepen_Setting UINT m_uiRead; UINT m_uiCodeID; UINT m_uiFullASCII; Members All members Telepen settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
UPCA_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UPCA_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiConvertToEAN13; UINT m_uiCoupon; UINT m_uiCouponXmitID; UINT m_uiXmitNumSys; Members All members UPCA settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
UPCE_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UPCE_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiConvertToUPCA; UINT m_uiXmitNumSys; Members All members UPCE settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Matrix25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Matrix25_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members Matrix25 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
UEGeneral_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UEGeneral_Setting UINT m_uiSuppReq; UINT m_ui2DigSupp; UINT m_ui5DigSupp; UINT m_ui2DigRedu; UINT m_ui5DigRedu; UINT m_uiGTIN; Members All members UPC/EAN General settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
IATA25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct IATA25_Setting UINT m_uiRead; UINT m_uiCodeID; Members All members IA TA2 of 5 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Trioptic_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Trioptic_Setting UINT m_uiRead; UINT m_uiCodeID; UINT m_uiConversion; Members All members TRI-OPTIC settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
RSS_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct RSS_Setting UINT m_uiRead; UINT m_uiXmitAppID; UINT m_uiXmitChkDig; UINT m_uiXmitSymID; Members All members settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
Page 250
0: Disable * Code ID setting 0x01 ~ 0x7F ASCII code(1 bytes) 0: Disable * UPC/EAN General Supplements Required 1: Enable 0: Disable * Two Digit Supplements 1: Enable 0: Disable * Five Digit Supplements 1: Enable 0: Disable * Two Digit Redundancy 1: Enable 0: Disable *...
Page 251
Note1: This command will set all barcode ID settings to proprietary value. It can' t be queried. Barcode value Barcode value Code 11 MSI Plessey Code 39 UK Plessey Code 93 Telepen Code 128 UPCA Codabar UPCE EAN8 Matrix 25 EAN13 IA TA 25 Industrial 2 of 5...
Page 252
Example: Cmd1 Cmd2 Value 670C 6514 6710 Code 128: Can only read barcode of 12- or 16-digit. Code 39: Can only read barcode of 20-digit. Note 3: ScanTimeout: the maximum time, in seconds, allowed during which the scanning beam remains ON without decoding any barcode.
Function Return Values Constant Value Description E_FUNC_SUCCEED 0x00000000 The function returned without error. E_FUNC_ERROR 0x00000001 The function returned error. E_FUNC_NULLPTR 0x00000002 A null pointer was passed to the function. E_FUNC_PAR_ERROR 0x00000003 An invalid parameter was passed to the function. E_FUNC_SCANNER_NOT_OPEN 0x00000004 The scanning device is not enabled.
Need help?
Do you have a question about the PT-9130 and is the answer not in the manual?
Questions and answers