структура 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 в децибелях над уровнем шума конфиденциальности устройства.
| Уровень сигнала (в dBm) | Закодированное значение (минимальное=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, чтобы указать, что драйвер минипорта не реализует отчеты на основе интервалов. Драйверы минипорта должны заполнять этот элемент интервалом в ответ на предыдущий запрос службы МБ для WWAN_RSSI_DEFAULT.
RssiThreshold
Текущее пороговое значение в единицах пороговых значений, в которых драйвер минипорта был установлен (или интервал по умолчанию, если он не установлен), что драйвер минипорта будет предоставлять обновления о состоянии сигнала. Укажите WWAN_RSSI_DISABLE, чтобы указать, что драйвер минипорта не реализует отчеты на основе порогового значения. Драйверы минипорта должны заполнять этот элемент пороговым значением в ответ на предыдущий запрос службы МБ для WWAN_RSSI_DEFAULT.
SignalStateListHeader
Отформатированная WWAN_LIST_HEADER структура, представляющая список расширений состояния сигнала для каждого класса данных и количество классов данных. Минипорт-драйвер должен вернуть список всех поддерживаемых классов данных.
Этот элемент указывает на список структур WWAN_SIGNAL_STATE_EXT, использующих структуру WWAN_LIST_HEADER. Остальные элементы структур WWAN_SIGNAL_STATE_EX заполняются на основе самого высокого доступного класса данных.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 7 и более поздних версиях Windows. |
| заголовка | wwan.h (include Wwan.h) |