Gettxpower(), Getwepstatus() – Intermec 751G User Manual

Page 99

Advertising
background image

Chapter 3 — Configuring the Computer

751G Color Mobile Computer User’s Manual

85

GetTXPower()

Call this function to get the current transmit power of the radio.

GetWepStatus()

Call this to get the current state of the radio’s WEP and encryption levels.

Syntax

UINT GetTXPower( ULONG & );

Parameters

NDIS_POWER_LEVEL_63

63 mW

NDIS_POWER_LEVEL_30

30 mW

NDIS_POWER_LEVEL_15

15 mW

NDIS_POWER_LEVEL_5

5 mW

NDIS_POWER_LEVEL_1

1 mW

NDIS_POWER_LEVEL_UNKNOWN Unknown Value or Error.

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 ULONG reference is populated with the TX power in
milliwatts (mW). Valid ranges are from 5 mW to 100 mW.

Definitions

#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetTXPower)(ULONG &);
#else
UINT GetTXPower(ULONG &);
#endif

Syntax

UINT GetWepStatus( ULONG & );

Parameters

NDIS_ENCRYPTION_1_ENABLED

WEP is enabled; TKIP and AES are not enabled, and a
transmit key may or may not be available. (same as
NDIS_RADIO_WEP_ENABLED)

NDIS_ENCRYPTION_DISABLED

Indicates AES, TKIP, WEP are disabled, transmit key
available. (Same as NDIS_RADIO_WEP_DISABLED)

NDIS_ENCRYPTION_NOT_SUPPORTED Indicates WEP, TKIP, AES not supported. (Same as

NDIS_RADIO_WEP_NOT_SUPPORTED)

NDIS_ENCRYPTION_1_KEY_ABSENT

Indicates AES, TKIP, WEP disabled, transmit key not
available. (Same as NDIS_RADIO_WEP_ABSENT)

NDIS_ENCRYPTION_2_ENABLED

Indicates that TKIP and WEP are enabled; AES is not
enabled, and a transmit key is available.

NDIS_ENCRYPTION_2_KEY_ABSENT

Indicates no transmit keys available for use by TKIP or
WEP, TKIP, WEP enabled; AES is not enabled.

NDIS_ENCRYPTION_3_ENABLED

Indicates that AES, TKIP, and WEP are enabled, and a
transmit key is available.

NDIS_ENCRYPTION_3_KEY_ABSENT

Indicates no transmit keys available for use by AES,
TKIP, WEP; and AES, TKIP, WEP enabled.

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 ULONG reference is populated with one of the parameters
listed above.

Definitions

#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetWepStatus)(ULONG &);
#else
UINT GetWepStatus(ULONG &);
#endif

Advertising