User's Manual

ProgrammingChapter 7
263700 Series Color Mobile Computer User’s Manual
GetDiversity()
Call this fu nction to get the current diversity setting of your 802.11b ra-
dio. This function uses an optional NDIS5.1 OID to query the radio,
which a large number of 802.11b 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 r ef erence is populated
with one of the parameters listed above.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetDiversity)(USHORT *);
#else
UINT GetDiversity(USHORT *);
#endif