Intermec 700 GetTXPower()

Programming—Chapter 7

275700Series Color Mobile Computer User’sManual

GetTXPower()

Call this function to get the current transmit pow er of the radio.

Syntax UINT GetTXPower( ULONG &);

Parameters NDIS_POWER_LEVEL_63 63 mW

NDIS_POWER_LEVEL_30 30mW

NDIS_POWER_LEVEL_15 15mW

NDIS_POWER_LEVEL_5 5mW

NDIS_POWER_LEVEL_1 1mW

NDIS_POWER_LEVEL_UNKNOWN Unknown Value or Error.

Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when th e query failed, or

ERR_CONNECT_FAILED if a connection with t he radio failed.

Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with the TX power in

milliwatts (mW).Valid ranges are from 5 mW to 100 mW.

Definitions #ifdef DYNAMIC_LOADING

typedef UINT (*PFN_GetTXPower)(ULONG &);

#else

UINT GetTXPower(ULONG &);

#endif

Contents

Main Page DocumentChange Record This page records changes to this document. The document was originally released as Revision A. Page Contents Introduction Windows Mobile 2003 Page Installing Applications NetworkSupport Page Printer Support Scanner Support Programming Page Configurable Settings A Page Troubleshooting B Page Page Before You Begin Safety Summary Donotrepairoradjustalone Firstaid Resuscitation Safety Icons Global Services and Support WarrantyInformation WebSupport TelephoneS upport WhoShouldReadthisManual? RelatedDocuments Patent Information Page Introduction Ambient Light Sensor Audio System Speaker Microphone External Headset Jack Battery Page Beeper Enablethe Beeper Disable the Scanner Mute Selecta Beeper Volume Page Page Keypad Backlight for Keypad KeySequences [Gold]or [Gold/White] Plane Keys NumericKeypad Alphanumeric Keypad Alpha(Blue) Plane Key s NumericKeypad Alphanumeric Keypad LEDs Modem Support PSM Build Version Resetting Your 700 Color Computer Performing a Warm-Boot Performing a Cold-Boot Software Build Version Storage Media CompactFlash Cards Secure Digital Cards Vibrator Wireless Network Support Accessories Physical and Environmental Specifications Page Page Windows Mobile 2003 Software Builds Where to Find Information Basic Skills TodayScreen Programs Navigation Bar and Command Bar Pop-up Menus Notifications Entering Information TypingWith the Onscreen Keyboard UsingBlock Recognizer Using Letter Recognizer UsingTranscriber SelectingTyped Text Writing on the Screen Selectingthe Writing ConvertingWriting to Text Page Drawingon the Screen Creatinga Drawing Selectinga Drawing Recordinga Message Creatinga Recording UsingMy Text Finding and Organizing Information Customizing Your 700 Color Computer Adjusting Settings Addingor Removing Programs AddingPrograms Using ActiveSyn c Addinga Program Directly fromthe Internet Addinga P rogramto theStart Men u Removing Programs Microsoft ActiveSync Page Microsoft PocketOutlook Calendar: Scheduling Appointments and Meetings SynchronizingCalendar Why Use Categories in the Calendar? Whatsan All Day Event? Whatsa R ecurrence Pattern? ViewingAppointments Page Creatingor Changing an Appointment Creatingan All Day Event Settinga Reminder for an Appointment Addinga Note to an Appointment Makingan Appointment Recurring Assigningan Appointmentto a Category Sendinga Meeting Request Findingan Appointment Deletingan Appointment Changing Calendar Options Contacts: Tracking Friends and Colleagues Creating a Contact SynchronizingContacts ViewingContacts Creating or Changing a Contact Addinga Note to a Contact Assigninga Contact to a Category Copying a Contact Sending a Message to a Contact Findinga Contact Deleting a Contact Addinga Contact to Speed Dial Changing Contacts Options Tasks: Keeping a To Do List Creating a Task SynchronizingTasks Notes: Capturing Thoughts and Ideas Creating a Note SynchronizingNotes Inbox: Sending and Receiving E-mail Messages SynchronizingE-mail Messages ManagingE-mail Messages and Folders Connectingto a Mail Server SettingUp or Changing an Account DownloadingMessages f rom the Server Composingand Sending Messages Companion Programs Pocket Word Creatinga Document TypingMode WritingMode RecordingMode DrawingMode Synchronizing Pocket Word Documents Pocket Excel Creating a Workbook Tips for Working in Pocket Excel MSNMessenger Setting Up an Account SigningIn and Out Workingwith Contacts ManagingContacts Sendinga Message WindowsMedia Player for Windows Mobile Microsoft Reader Getting Books on Your 700 Color Computer Usingthe Library Readinga Book UsingReader Features Removing a Book Pocket Internet Explorer The Mobile Favorites Folder Favorite Links Mobile Favorites Using AvantGo Channels Using Pocket Internet Explorer ViewingMobile Favorites and Channels Browsingthe Internet Getting Connected Connecting to an Internet Service Provider Page Page Page Connecting to Work Page Page Page Creatinga Wireless Network Connection Page Page Page Page Creatinga VPN Server Connection to Work Page Page Ending a Connection Connecting Directly to an E-mail Server SettingUp an E-mail Account Page Page Page Packaging an Application Installing Applications Using Microsoft ActiveSync Usingthe FTP Server Using a Storage Card Copying to a CompactFlash Card Copyingto a Secure Digital Storage Card Replicating 700 Color SettingsUsing the Registry Deletingthe Old Registry File Copyingthe RegFlush CAB File Loadingthe Registry Save Application Page Updating the System Software Migrating Applications Page Migrating from a 700 Monochrome Computer Installing Cabinet Files Page Understanding Your 700 Series Computer Antennas (760/761 Computers) Network Adapters Page No Networking Network Selection APIs Network Connections CORE (760, 761 Computers with WAN Radios) ActivatingCORE Install an Available Radio Module Loading a Radio Module 802.11 CF COREModule General Details CDMA/1xRTTCORE Module (760 Computers with WAN Radios) WANMonitor General WANMonitor Details GSM/GPRS CORE Module (760 Computers with WAN Radios) WANMonitor General WANMonitor Details Microsoft Phone Application (761 Computers with CDMA Radios) Data Provisioning (Sprint) Page Data Provisioning (Verizon) Page Phone Application Page Tools Phone Settings Page Page Microsoft Phone Application (761 Computers with GSM Radios) Activation Phone Application Page Tools Phone Settings Page Page PhoneUtility (760 Computers with GSM/GPRS Radios) Audio Mode Page Page SB555 Watcher (760 Computers with CDMA Radios) CopyingC DMA RadioModule CABFiles from Intermec Web Site Via Microsoft ActiveSync Via a CompactFlash or Secure Digital Storage Card Finishing the Installation Activation Page Page Verizon Automated Activation Process Page Page Page SprintAutomated Activation Process Page Page Page UsingSprint Watcher Page Page Page DataProvisioning Page Page Telus and Bell Mobility Activation AT Command Interface (760 Computers) CommandSet for Sierra Wireless SB555 Command Set for Siemens MC45 or MC46 Testingthe AT Commands Page Page Page Wireless Personal Area Networking Documentation About the Application Page WirelessPrinting Properties Page Page AutoIP/DHCP SNMP Configuration on the 700 Color Computer Management Information Base ObjectIdentifiers Configuring with SNMP Printer Support Printing ASCII Directly to a Port Directly to a Generic Serial Port IrDA Printer Driver NPCP Printer Driver About NPCP NPCP Driver Installation and Removal Opening the NPCP Driver Closing the NPCP Driver Reading from the NPCP Driver Writing to the NPCP Driver NPCP Driver I/O Controls NPCP Printer Communications Sample Code NPCP Error Codes ONeil Printer Driver DTRDriver Installation and Removal Opening the DTR Driver Closing the DTR Driver Writing to the DTR Driver DTR Printer Communications Page Scanner Support Scanner Control and Data Transfer Data Collection Configuration Internal Scanners For Units With PSM Build 3.00 or Newer Scanner and Imager Settings Internal Scanner Supported Symbologies Tethered Scanners ForUnits With PSM Builds Older than 3.00 Enablingand Disabling ErrorMes sage Changing Comm Settings Page ScannerCabling Limitationsand Capabilities Page For Units With PSM Build 3.00 or Newer Configuringthe Tethered Scanner Page 1551Eor 1553 Selected for Scanner Model ASCIIS elected for Scanner Model Troubleshootingthe 1551E/1553 Tethered Scanner Reset Factory Defaults TetheredScanner Supported Symbologies Programming Creating CAB Files Creating Device-Specific CAB Files Creatingan .INF File [Version] [CEStrings] [Strings] [CEDevice] Page [DefaultInstall] [SourceDiskNames] [SourceDiskFiles] [DestinationDirs] [CopyFiles] [AddReg] [CEShortCuts] Sample.INF File Page Page UsingInstallation Functions in SETUP.DLL Afterthe CAB File Extraction Page Page Creating CAB Files with CAB Wizard Troubleshooting the CAB Wizard Customization and Lockdown FTP Server Synopsis Configurable Parameters Via the Registry Editor BlockSize DeviceName DeviceURL IDNATarget ManifestName PauseAtStartup Root TransferringF iles Over TCP/IP Networks Remarks Page Page Stopping the FTP Server from Your Application Autostart FTP Page Kernel I/O Controls IOCTL_HAL_GET_DEVICE_INFO IOCTL_HAL_ITC_READ_PARM IDField Values The id field of the PARMS structure may be one of the following values: Page Page Page IOCTL_HAL_ITC_WRITE_SYSPARM IDField Values The id field of lpInBuf may be one of the following values: IOCTL_HAL_GET_DEVICEID IOCTL_HAL_GET_OAL_VERINFO Returns the HAL version informationof the Pocket PC image. IOCTL_HAL_GET_BOOTLOADER_VERINFO Returns the HAL version informationof the Pocket PC image. IOCTL_HAL_WARMBOOT IOCTL_HAL_COLDBOOT IOCTL_HAL_GET_RESET_INFO This IOCTL code allowssoftware to check the type of the most recent reset. Sample IOCTL_HAL_GET_BOOT_DEVICE This IOCTL code allows software to check which devic e CE booted from. IOCTL_HAL_REBOOT IOCTL_PROCESSOR_INFORMATION Returnsprocessor information. #include pkfuncs.h IOCTL_GET_CPU_ID Network Selection APIs Page Basic Connect/Disconnect Functions RadioConnect() RadioDisconnect() RadioDisassociate() Query Information Functions GetAssociationStatus() GetAuthenticationMode() Call this function to obtain the radios curre ntau thentication mode. GetBSSID() GetDiversity() GetLinkSpeed() GetMac() Call this function to get the MAC address of the 802.11b or 802.11b/g radio. GetNetworkMode() Call this function to get the current Networ k Mode (SSID) for the 802.11b or 802.11b/g radio. GetNetworkType() GetSSID() GetPowerMode() Call this function to get the current power savings mode of the radio. Note: Do not use Automatic Switching mode at this time. GetRSSI() Call this function to get the current RSSI (Radi o Signal Strength Indica- tor), in Dbm. GetTXPower() Call this function to get the current transmit pow er of the radio. GetWepStatus() Call thisfunction to get the current state of the radiosWEP and encryp- tion levels. GetRadioIpAddress() GetCCXStatus() Call this function to get information about the cur rent CCX status of the adapter. Set Information Functions AddWep() EnableWep() Enables or disables WEP encryption on the radio (TRUE/FALSE). EncryptionStatus() Call this function to set the desired encryption status. SetAuthenticationMode() Call this function to set the desired authentication mode . SetChannel() SetNetworkMode() Call this function to set the desired Networ k Mode. SetPowerMode() Call this function to set the desired power mode . SetSSID() SetCCXStatus() Call this function to set the desired CCX / Network EAP status. SetMixedCellMode() Call this function to set the desired mixe d cell mode. Helper Functions ConfigureProfile() EnableZeroConfig() isZeroConfigEnabled() isOrinoco() isSupplicantRunning() StartScanList() StartSupplicant() StopSupplicant() Call this function to stop the supplicant service . isDHCPEnabled() Call this function to determine whether DH CP is enabled on the current adapter. RenewDHCP() GetCurrentDriverName() Call this function to populate the TCHAR array with the driver name. ResetRadioToSystemSave() Call this function to force the radio to rese t to the last desired active pro- file. EnableSuppLogging() DeprecatedFunctions Notifications NLEDGetDeviceInfo NLEDSetDevice Reboot Functions Remapping the Keypad Unshifted Plane GoldPlane Alpha (Blue) Plane Key Values NumericKey pad AlphanumericKeypad How KeyValues AreStored in Registry ChangeNotification Advanced Keypad Remapping Scan Codes NumericKey pad NumericK eypad Scan Codes and Meanings (continued) AlphanumericKeypad AlphanumericKeypad Scan Codes and Meanings (continued) Sample View of Registry Keys Configurable Settings A Configuration Parameters Changinga ParameterSetting About Configuration Parameters Data Collection Control Panel Applet Symbologies Code39 Note:IfBar code length =1thenMinimumlength is entered. 1.3.6.1.4.1.1963.15.3.3.1.1.3.1 Standard2 of 5 Codabar Codabar is a self-checking, discrete symbology. 1.3.6.1.4.1.1963.15.3.3.1.1.5.1 UPC/EAN UPC/EAN are fixed-length, numeric, continu ous symbologies that use four element widths. 1.3.6.1.4.1.1963.15.3.3.1.1.6.1 Page Page Code128 Options Code128 FNC1 Character Plessey MSI Page Page Page Interleaved2 of 5 Page Page Code11 Page Page Page Symbology Options Symbology ID Code39 User ID Code128 User ID CodabarUser ID Code93 User ID Interleaved 2 of 5 User ID PDF417User ID MSIUser ID PlesseyUser ID Standard2 of 5 User ID UPCA User ID UPCE User ID EAN8 User ID EAN13 User ID Matrix2 of 5 User ID TelepenUser ID Code11 User ID Page Page Beeper/LED Page Page Page Page Page Imager AimerLED Du ration Page Page Page Page Virtual Wedge VirtualWedge Preamble Page Postamble Page Grid Page Intermec Settings Control Panel Applet SNMP Control Panel Applet Security Page Page Page Page Traps Page Identification Page Page Unit Information Control Panel Applet Versions Page CAB Files Page Utilities Control Panel Applet Dock Switch Registry Save Wakeup Mask App Launch Page Wireless Network Control Panel Applet Aboutthe Wireless Network Terminology Page Configuring Your Wireless Network Basic Security None Page Page PEAP(Protected EAP) Page Page Page TLS(EAP-TLS) Page Page TTLS(E AP-Tunneled TLS) Page Page ToGet Certificates LEAP(C isco Lightweight EAP) Page Page Advanced Other Configurable Parameters Using Reader Commands Change Configuration Example1 Example2 Set Time and Date Configuration Bar Codes Page Page Virtual Wedge Grid, Preamble, Postamble Grid *$+AF Preamble *$+AD Postamble *$+AE Page Page Page Page Classes and Functions Page Page Page Page Page General Index Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Files Index Page *961-054-031H*