Chapter 3 — Configuring the Computer

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.

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

GetLinkSpeed()

Call this function to get the current link speed of the 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

751G Color Mobile Computer User’s Manual

81

Page 95
Image 95
Intermec 751G user manual Uint GetDiversity Ushort, Uint GetLinkSpeed int