Chapter 3 — Configuring the Computer
751G Color Mobile Computer User’s Manual 81
GetDiversity()
Call this function to get the current diversity setting of your 802.11b/g
radio. This function uses an optional NDIS5.1 OID to query the radio,
which a large number of 802.11b/g devices do not support. This function
may be inaccurate.
GetLinkSpeed()
Call this function to get the current link speed of the 802.11b/g radio.
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 parameters
listed above.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetDiversity)(USHORT *);
#else
UINT GetDiversity(USHORT *);
#endif
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