Getdiversity(), Getlinkspeed() – Intermec 700 User Manual
Page 295

Programming
—
Chapter 7
271
700 Series Color Mobile Computer User’s Manual
GetDiversity()
Call this function to get the current diversity setting of your 802.11b or
802.11b/g radio. This uses an optional NDIS5.1 OID to query the radio,
of which a large number of 802.11b or 802.11b/g devices do not support.
This may be inaccurate.
Syntax
UINT GetDiversity(USHORT *);
Parameters
ANT_PRIMARY
The primary antenna is selected.
ANT_SECONDARY
The secondary antenna is selected.
ANT_DIVERSITY
The radio is in diversity mode, and uses both antennas
Return Values
ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or
ERR_CONNECT_FAILED if a connection with the radio failed.
Remarks
If ERROR_SUCCESS is returned, your USHORT reference is populated with one of the parame-
ters listed above.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetDiversity)(USHORT *);
#else
UINT GetDiversity(USHORT *);
#endif
GetLinkSpeed()
Call this function to get the current link speed of the 802.11b or
802.11b/g radio.
Syntax
UINT GetLinkSpeed( int & );
Parameters
This function accepts an int reference, and your int is populated with the current link speed, in
Mbps, rounded to the nearest whole integer, for example: 1, 2, 5, 11, etc.
Return Values
ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or
ERR_CONNECT_FAILED if a connection with the radio failed.
Remarks
Data returned is valid if ERROR_SUCCESS is returned.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetLinkSpeed)(int &);
#else
UINT GetLinkSpeed(int &);
#endif