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

Page 295

Advertising
background image

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

Advertising