Getdiversity(), Getlinkspeed() – Intermec 751G User Manual

Page 95

Advertising
background image

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

Advertising