Hardware Dev Center

Expand Minimize

WWAN_SIGNAL_STATE structure

The WWAN_SIGNAL_STATE structure represents the signal state of the MB device.

Syntax


typedef struct _WWAN_SIGNAL_STATE {
  ULONG Rssi;
  ULONG ErrorRate;
  ULONG RssiInterval;
  ULONG RssiThreshold;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;

Members

Rssi

A value that represents the strength of the wireless signal. Miniport drivers that report their WWAN_CELLULAR_CLASS to be WwanCellularClassGSM or WwanCellularClassCDMA must report Rssi in decibels above the device's sensitivity noise floor.

Signal Strength (in dBm)Coded Value (Minimum=0, Maximum=31)

-113 or less

0

-111

1

-109

2

...

...

-51 or greater

31

Unknown or undetectable

WWAN_RSSI_UNKNOWN

 

CDMA-based devices must report signal strength based on compensated RSSI (accounts for noise) and not based on raw RSSI.

ErrorRate

A coded value that represents a percentage range of error rates. For GSM-based devices, use the values from the Channel bit error rate column in the following table. For CDMA-based devices, use the values from the Frame error rate column. For both cases, use WWAN_ERROR_RATE_UNKNOWN to denote an unknown error rate.

Channel bit error rate (in %)Frame error rate (in %)Coded value (Min=0, Max=7)

< 0.2

< 0.01

0

0.2-0.4

0.01-0.1

1

0.4-0.8

0.1-0.5

2

0.8-1.6

0.5-1.0

3

- 3.2

1.0 - -2.0

4

- 6.4

2.0-4.0

5

6.4-12.8

4.0-8.0

6

> 12.8

> 8.0

7

Unknown or undetectable

WWAN_ERROR_RATE_UNKNOWN

 

RssiInterval

The current interval, in seconds, at which the miniport driver has been set to (or the default interval, if one has not been set), that the miniport driver will provide updates about the signal state. Specify WWAN_RSSI_DISABLE to indicate that the miniport driver does not implement interval-based reporting. Miniport drivers should populate this member with the interval in response to an earlier request from the MB Service for WWAN_RSSI_DEFAULT.

RssiThreshold

The current threshold, in threshold units, at which the miniport driver has been set to (or the default interval, if one has not been set), that the miniport driver will provide updates about the signal state. Specify WWAN_RSSI_DISABLE to indicate that the miniport driver does not implement threshold-based reporting. Miniport drivers should populate this member with the threshold units in response to an earlier request from the MB Service for WWAN_RSSI_DEFAULT.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Wwan.h (include Wwan.h)

See also

NDIS_WWAN_SIGNAL_STATE

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft