структура WWAN_SIGNAL_STATE_EXT (wwan.h)
Структура WWAN_SIGNAL_STATE_EXT представляет расширение для состояния сигнала устройства МБ. В Windows 10 версии 1903 и более поздних версий WWAN_SIGNAL_STATE_EX содержит основную информацию о состоянии сигнала устройства, включая массив структур WWAN_SIGNAL_STATE_EXT, содержащих сведения о состоянии сигнала, относящиеся к 5G.
Дополнительные сведения о поддержке класса данных 5G см. в разделе MB 5G data class support.
Синтаксис
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
Члены
RSRP
Эталонный сигнал получил мощность (RSRP), которая варьируется от -156 до -31 в единицах 1 dBm. Используйте WWAN_RSRP_UNKNOWN, если эта информация недоступна. В следующей таблице показано, как сопоставить диапазон с элементом RSRP.
| Указанное значение | Измеренное значение количества (L3 SS_RSRP) | Измеренное значение количества (L1 SS-RSRP и CSI-RSRP) | Единица |
|---|---|---|---|
| RSRP_0 | SS-RSRP<-156 | Недопустимый | Дбм |
| RSRP_1 | -156≤ SS-RSRP<-55 | Недопустимый | Дбм |
| RSRP_2 | -155≤ SS-RSRP<-54 | Недопустимый | Дбм |
| RSRP_3 | -154≤ SS-RSRP<-153 | Недопустимый | Дбм |
| RSRP_4 | -153≤ SS-RSRP<-152 | Недопустимый | Дбм |
| RSRP_5 | -152≤ SS-RSRP<-151 | Недопустимый | Дбм |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP<-140 | Недопустимый | Дбм |
| 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 | Дбм |
| RSRP_112 | -45≤ SS-RSRP<-44 | -45≤ RSRP | Дбм |
| RSRP_113 | -44≤ SS-RSRP<-43 | Недопустимый | Дбм |
| RSRP_114 | -43≤ SS-RSRP<-42 | Недопустимый | Дбм |
| RSRP_115 | -42≤ SS-RSRP<-41 | Недопустимый | Дбм |
| RSRP_116 | -41≤ SS-RSRP<-40 | Недопустимый | Дбм |
| RSRP_117 | -40≤ SS-RSRP<-39 | Недопустимый | Дбм |
| RSRP_118 | -39≤ SS-RSRP<-38 | Недопустимый | Дбм |
| RSRP_119 | -38≤ SS-RSRP<-37 | Недопустимый | Дбм |
| RSRP_120 | -37≤ SS-RSRP<-36 | Недопустимый | Дбм |
| RSRP_121 | -36≤ SS-RSRP<-35 | Недопустимый | Дбм |
| RSRP_122 | -35≤ SS-RSRP<-34 | Недопустимый | Дбм |
| RSRP_123 | -34≤ SS-RSRP<-33 | Недопустимый | Дбм |
| RSRP_124 | -33≤ SS-RSRP<-32 | Недопустимый | Дбм |
| RSRP_125 | -32≤ SS-RSRP<-31 | Недопустимый | Дбм |
| RSRP_126 | -31≤ SS-RSRP | Недопустимый | Дбм |
| RSRP_127 | Бесконечность | Недопустимый | Дбм |
Этот элемент действителен только в том случае, если для элемента dataClass задано значение WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA. В противном случае используйте WWAN_RSRP_UNKNOWN.
RSRPThreshold
Текущее пороговое значение в единицах порогового значения (1 dBm), в котором был установлен драйвер мини-порта (или пороговое значение по умолчанию, если он не установлен), где драйвер минипорта предоставляет обновления о состоянии сигнала. Укажите WWAN_RSRP_DISABLE, чтобы указать, что драйвер не реализует отчеты на основе порогового значения. Драйвер минипорта должен заполнить этот элемент пороговым значением в ответ на более ранний запрос из службы МБ для WWAN_RSRP_DEFAULT.
Этот элемент действителен только в том случае, если для элемента dataClass задано значение WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA. В противном случае используйте WWAN_RSRP_DISABLE.
SNR
Соотношение сигналов к шуму (SNR) от -23 до 40 единиц в единицах 0,5 dB. Используйте WWAN_SNR_UNKNOWN, если эта информация недоступна. В следующей таблице показано, как сопоставить диапазон с элементом SNR.
| Указанное значение | Измеряемое значение количества | Единица |
|---|---|---|
| SNR_0 | SNR<-23 | дБ |
| SNR_1 | -23≤ SNR<-22.5 | дБ |
| SNR_2 | -22.5≤ SNR<-22 | дБ |
| SNR_3 | -22≤ SNR<-21.5 | дБ |
| SNR_4 | -21.5≤ SNR<-21 | дБ |
| ... | ... | ... |
| SNR_123 | 38≤ SNR<38.5 | дБ |
| SNR_124 | 38.5≤ SNR<39 | дБ |
| SNR_125 | 39≤ SNR<39.5 | дБ |
| SNR_126 | 39.5≤ SNR<40 | дБ |
| SNR_127 | 40≤ SNR | дБ |
Этот элемент действителен только в том случае, если для элемента dataClass задано значение WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA. В противном случае используйте WWAN_SNR_UNKNOWN.
SNRThreshold
Текущее пороговое значение в единицах порогового значения (1 dBm), в котором был установлен драйвер мини-порта (или пороговое значение по умолчанию, если он не установлен), где драйвер минипорта предоставляет обновления о состоянии сигнала. Укажите WWAN_SNR_DISABLE, чтобы указать, что драйвер не реализует отчеты на основе пороговых значений. Минипорт-драйвер должен заполнить этот элемент пороговым значением в ответ на более ранний запрос из службы МБ для WWAN_SNR_DEFAULT.
Этот элемент действителен только в том случае, если для элемента dataClass задано значение WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA. В противном случае используйте WWAN_SNR_DISABLE.
DataClass
Указывает класс данных, для которого допустимы параметры. Только если задан WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA, RSRP, RSRPThreshold, SNRи членов SNRThreshold.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 версии 1903 |
| заголовка | wwan.h (include Wwan.h) |