User's Manual

ProgrammingChapter —7
268 700 Series Color Mob ile Computer User’s Manual
GetDiversity()
Call this function to get the curre nt diversity setting of you r 802.11b ra-
dio. This uses an optional NDIS5.1 OID to query the radio, of which a
large number of 802.11b devices do not support. This may be inaccurate.
Syntax UINT GetDiversity(USHORT *);
Parameters ANT_PRIMARY The primary antenna is selecte d.
ANT_SECONDARY The secondary antenna is selected.
ANT_DIVERSITY The radio is in diversity mode, and us e s 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 cur rent link speed of the 802. 11b radio.
Syntax UINT GetLinkSpeed( int & );
Parameters This func tion 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