Поделиться через

структура 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)

См. также раздел

WWAN_SIGNAL_STATE