WWAN_SIGNAL_STATE_EXT structure (wwan.h)
The WWAN_SIGNAL_STATE_EXT structure represents an extension to the signal state of the MB device. In Windows 10, version 1903 and later, WWAN_SIGNAL_STATE_EX contains primary information about the signal state of the device, including an array of WWAN_SIGNAL_STATE_EXT structures that contain signal state information specific to 5G.
For more info about 5G data class support, see MB 5G data class support.
Syntax
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
Members
RSRP
The reference signal received power (RSRP), that ranges from -156 to -31, in units of 1 dBm. Use WWAN_RSRP_UNKNOWN when this information is not available. The following table shows how to map the range to the RSRP member.
| Reported value | Measured quantity value (L3 SS_RSRP) | Measured quantity value (L1 SS-RSRP and CSI-RSRP) | Unit |
|---|---|---|---|
| RSRP_0 | SS-RSRP<-156 | Not valid | dBm |
| RSRP_1 | -156≤ SS-RSRP<-55 | Not valid | dBm |
| RSRP_2 | -155≤ SS-RSRP<-54 | Not valid | dBm |
| RSRP_3 | -154≤ SS-RSRP<-153 | Not valid | dBm |
| RSRP_4 | -153≤ SS-RSRP<-152 | Not valid | dBm |
| RSRP_5 | -152≤ SS-RSRP<-151 | Not valid | dBm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP<-140 | Not valid | dBm |
| RSRP_17 | -140≤ SS-RSRP<-139 | RSRP<-139 dBm | |
| RSRP_18 | -139≤ SS-RSRP<-138 | -139≤ RSRP<-138 dBm | |
| ... | ... | ... | ... |
| RSRP_111 | -46≤ SS-RSRP<-45 | -46≤ RSRP<-45 | dBm |
| RSRP_112 | -45≤ SS-RSRP<-44 | -45≤ RSRP | dBm |
| RSRP_113 | -44≤ SS-RSRP<-43 | Not valid | dBm |
| RSRP_114 | -43≤ SS-RSRP<-42 | Not valid | dBm |
| RSRP_115 | -42≤ SS-RSRP<-41 | Not valid | dBm |
| RSRP_116 | -41≤ SS-RSRP<-40 | Not valid | dBm |
| RSRP_117 | -40≤ SS-RSRP<-39 | Not valid | dBm |
| RSRP_118 | -39≤ SS-RSRP<-38 | Not valid | dBm |
| RSRP_119 | -38≤ SS-RSRP<-37 | Not valid | dBm |
| RSRP_120 | -37≤ SS-RSRP<-36 | Not valid | dBm |
| RSRP_121 | -36≤ SS-RSRP<-35 | Not valid | dBm |
| RSRP_122 | -35≤ SS-RSRP<-34 | Not valid | dBm |
| RSRP_123 | -34≤ SS-RSRP<-33 | Not valid | dBm |
| RSRP_124 | -33≤ SS-RSRP<-32 | Not valid | dBm |
| RSRP_125 | -32≤ SS-RSRP<-31 | Not valid | dBm |
| RSRP_126 | -31≤ SS-RSRP | Not valid | dBm |
| RSRP_127 | Infinity | Not valid | dBm |
This member is valid only if the DataClass member is set to WWAN_DATA_CLASS_LTE or WWAN_DATA_CLASS_5G_NSA/SA. Otherwise, use WWAN_RSRP_UNKNOWN.
RSRPThreshold
The current threshold, in threshold units (1 dBm), at which the miniport driver has been set (or the default threshold, if one has not been set), where the miniport driver provides updates about the signal state. Specify WWAN_RSRP_DISABLE to indicate that the driver does not implement threshold-based reporting. The miniport driver should populate this member with the threshold units in response to an earlier request from the MB service for WWAN_RSRP_DEFAULT.
This member is valid only if the DataClass member is set to WWAN_DATA_CLASS_LTE or WWAN_DATA_CLASS_5G_NSA/SA. Otherwise, use WWAN_RSRP_DISABLE.
SNR
The signal-to-noise (SNR) ratio, ranging from -23 to 40, in units of 0.5 dB. Use WWAN_SNR_UNKNOWN when this information is not available. The following table shows how to map the range to the SNR member.
| Reported value | Measured quantity value | Unit |
|---|---|---|
| SNR_0 | SNR<-23 | dB |
| SNR_1 | -23≤ SNR<-22.5 | dB |
| SNR_2 | -22.5≤ SNR<-22 | dB |
| SNR_3 | -22≤ SNR<-21.5 | dB |
| SNR_4 | -21.5≤ SNR<-21 | dB |
| ... | ... | ... |
| SNR_123 | 38≤ SNR<38.5 | dB |
| SNR_124 | 38.5≤ SNR<39 | dB |
| SNR_125 | 39≤ SNR<39.5 | dB |
| SNR_126 | 39.5≤ SNR<40 | dB |
| SNR_127 | 40≤ SNR | dB |
This member is valid only if the DataClass member is set to WWAN_DATA_CLASS_LTE or WWAN_DATA_CLASS_5G_NSA/SA. Otherwise, use WWAN_SNR_UNKNOWN.
SNRThreshold
The current threshold, in threshold units (1 dBm), at which the miniport driver has been set (or the default threshold, if one has not been set), where the miniport driver provides updates about the signal state. Specify WWAN_SNR_DISABLE to indicate that the driver does not implement threshold-based reporting. The miniport driver should populate this member with the threshold units in response to an earlier request from the MB service for WWAN_SNR_DEFAULT.
This member is valid only if the DataClass member is set to WWAN_DATA_CLASS_LTE or WWAN_DATA_CLASS_5G_NSA/SA. Otherwise, use WWAN_SNR_DISABLE.
DataClass
Indicates the data class for which the parameters are valid. Only if either WWAN_DATA_CLASS_LTE or WWAN_DATA_CLASS_5G_NSA/SA is set, then the RSRP, RSRPThreshold, SNR, and SNRThreshold members are valid.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1903 |
| Header | wwan.h (include Wwan.h) |