структура WWAN_SIGNAL_STATE (wwan.h)

Статья
08/08/2023

Структура WWAN_SIGNAL_STATE представляет состояние сигнала устройства в МБ.

Синтаксис

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

Члены

Rssi

Значение типа , представляющее силу беспроводного сигнала. Драйверы мини-портов, которые сообщают о своих WWAN_CELLULAR_CLASS WwanCellularClassGSM или WwanCellularClassCDMA , должны сообщать о rssi в децибелах выше уровня шума чувствительности устройства.

Сила сигнала (в дБм)	Закодированное значение (минимум=0, максимум=31)
-113 или меньше	0
-111	1
-109	2
...	...
-51 или больше	31
Неизвестный или неизобнаружимый	WWAN_RSSI_UNKNOWN

Устройства на основе CDMA должны сообщать о силе сигнала на основе компенсированного RSSI (учета шума), а не на основе необработанных RSSI.

ErrorRate

Закодированное значение, представляющее процентный диапазон частоты ошибок. Для устройств на основе GSM используйте значения из столбца Скорость ошибок битов канала в следующей таблице. Для устройств на основе CDMA используйте значения из столбца Частота ошибок кадра. В обоих случаях используйте WWAN_ERROR_RATE_UNKNOWN для обозначения неизвестной частоты ошибок.

Частота ошибок битов канала (в %)	Частота ошибок кадра (в %)	Закодированное значение (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
Неизвестный или неизобнаружимый		WWAN_ERROR_RATE_UNKNOWN

RssiInterval

Текущий интервал (в секундах), через который драйверу мини-порта был задано значение (или интервал по умолчанию, если он не был задан), который драйвер минипорта будет предоставлять обновления о состоянии сигнала. Укажите WWAN_RSSI_DISABLE, чтобы указать, что драйвер мини-порта не реализует отчеты на основе интервалов. Драйверы минипорта должны заполнить этот элемент интервалом в ответ на предыдущий запрос от службы MB для WWAN_RSSI_DEFAULT.

RssiThreshold

Текущее пороговое значение (в единицах порога), при котором драйверу мини-порта задано значение (или интервал по умолчанию, если он не задан), которое драйвер мини-порта будет предоставлять обновления о состоянии сигнала. Укажите WWAN_RSSI_DISABLE, чтобы указать, что драйвер мини-порта не реализует отчеты на основе пороговых значений. Драйверы miniport должны заполнить этот элемент пороговым значением в ответ на предыдущий запрос от службы MB для WWAN_RSSI_DEFAULT.

SignalStateListHeader

Отформатированная структура WWAN_LIST_HEADER , представляющая список расширений состояния сигнала для каждого класса данных и количество классов данных. Драйвер мини-порта должен возвращать список всех поддерживаемых классов данных.

Этот элемент указывает на список WWAN_SIGNAL_STATE_EXT структур, использующих структуру WWAN_LIST_HEADER . Остальные члены WWAN_SIGNAL_STATE_EX структур заполняются на основе самого высокого доступного класса данных.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть	wwan.h (включая Wwan.h)

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

NDIS_WWAN_SIGNAL_STATE

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