OID_WWAN_SIGNAL_STATE
OID_WWAN_SIGNAL_STATE возвращает или задает текущее состояние сигнала.
Драйверы минипорта должны обрабатывать и запрашивать запросы асинхронно, первоначально возвращая NDIS_STATUS_INDICATION_REQUIRED исходному запросу, а затем отправлять уведомление о состоянии NDIS_STATUS_WWAN_SIGNAL_STATE, содержащее структуру NDIS_WWAN_SIGNAL_STATE, чтобы предоставить сведения о текущем состоянии сигнала, отображаемом пользователю независимо от завершения набора или запроса.
Вызывающие пользователи, запрашивающие указание текущего состояния сигнала, предоставляют пользователю NDIS_WWAN_SET_SIGNAL_INDICATION структуру минипорта с соответствующими сведениями.
Дополнительные сведения об использовании этого OID см. в операций с силой сигнала WWAN.
Драйверы мини-порта не должны обращаться к сети поставщика или модулю удостоверений подписчика (SIM-карта), при обработке запросов или задания операций.
Как правило, следует указывать состояние сигнала, а не опрашивать. Однако этот OID доступен в случае, если текущее состояние сигнала должно быть определено службой МБ.
Чтобы ответить на запросы, драйверы минипорта должны отправлять уведомления NDIS_STATUS_WWAN_SIGNAL_STATE.
В запросе набора из службы MB драйверы минипорта должны:
Возвращает текущие значения для Rssi и ErrorRate в структуре NDIS_WWAN_SIGNAL_STATE в дополнение к отправке абсолютных значений для RssiInterval и RssiThreshold, который был задан в драйвере мини-порта.
Внутренне кэшируйте значения RssiInterval и/или rssiThreshold, даже если устройство не зарегистрировано с любым оператором и что любое ограничение, введенное устройством в параметрах параметров, может быть возможным только после регистрации. Минипорт-драйвер должен попытаться применить эти параметры в следующей немедленной доступной ситуации.
Завершите запрос успешно, если состояние аппаратного и /или программного переключателя в настоящее время отключено. Минипорт драйвер кэширует данные запроса и начинает сообщать о силе сигнала после включения переключателя.
Может завершиться сбоем этого запроса с соответствующим набором кода ошибки uStatus.
Драйверы мини-порта могут выполнять следующие действия при обработке запросов из службы MB:
Возвращает текущие значения для Rssi и ErrorRate в структуре NDIS_WWAN_SIGNAL_STATE в дополнение к отправке абсолютных значений для RssiInterval и RssiThreshold, который был задан в драйвере мини-порта.
Завершите этот запрос соответствующим набором кода ошибки uStatus.
Возвращаемые значения:
NDIS_STATUS_NOT_SUPPORTED
Мини-порты могут возвращать это для определенных устройств, которые знают о возможностях устройств, не поддерживающих силу сигнала, может завершиться сбоем запроса с этим кодом ошибки.
рекомендуемую реализацию
Устройства должны поддерживать показатели надежности сигнала.
Водители должны сообщать о силе сигнала по крайней мере 50% RssiInterval за пять минут.
Устройства должны избегать передачи данных о силе сигнала в следующих состояниях:
Устройство не зарегистрировано или не зарегистрировано и применяется только для устройств GSM.
Эффективное состояние радио — OFF.
В указанных выше состояниях запрос к силе сигнала должен возвращаться следующими данными минипорт-драйвером:
Rssi = WWAN_RSSI_UNKNOWN
ErrorRate = WWAN_ERROR_RATE_UNKNOWN;
RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT или последнее значение набора>
RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT или последнее значение набора>
Начиная с Windows 10 версии 1903, OID_WWAN_SIGNAL_STATE обновлен до версии 3. Эта редакция позволяет узлу запрашивать новые эталонные сигналы, полученные значения питания (RSRP) и SIGNAL-to-Noise (SNR) из мини-драйвера. Минипорт-драйвер должен использовать версию 3 этой OID и ее структуры данных, если драйвер поддерживает 5G.
Дополнительные сведения о поддержке класса данных 5G см. в разделе MB 5G data class support.
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (include Ndis.h) |