структура WWAN_SIGNAL_STATE (wwan.h)
Структура 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) |