структура 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.
Синтаксис
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 дБм. Используйте WWAN_RSRP_UNKNOWN , если эти сведения недоступны. В следующей таблице показано, как сопоставить диапазон с элементом RSRP.
| Переданное значение | Измеряемое значение количества (L3 SS_RSRP) | Измеряемое значение количества (L1 SS-RSRP и CSI-RSRP) | Unit |
|---|---|---|---|
| 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 | Infinity | Недопустимая | Дбм |
Этот элемент действителен, только если для элемента DataClass задано значение WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA. В противном случае используйте WWAN_RSRP_UNKNOWN.
RSRPThreshold
Текущее пороговое значение в единицах порога (1 дБм), по которому был установлен драйвер минипорта (или пороговое значение по умолчанию, если оно не было задано), где драйвер минипорта предоставляет обновления о состоянии сигнала. Укажите 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 дБ. Используйте WWAN_SNR_UNKNOWN , если эти сведения недоступны. В следующей таблице показано, как сопоставить диапазон с элементом SNR.
| Переданное значение | Измеряемое значение количества | 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 |
Этот элемент действителен, только если для элемента DataClass задано значение WWAN_DATA_CLASS_LTE или WWAN_DATA_CLASS_5G_NSA/SA. В противном случае используйте WWAN_SNR_UNKNOWN.
SNRThreshold
Текущее пороговое значение в единицах порога (1 дБм), по которому был установлен драйвер минипорта (или пороговое значение по умолчанию, если оно не было задано), где драйвер минипорта предоставляет обновления о состоянии сигнала. Укажите 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 (включая Wwan.h) |