OID_WWAN_SIGNAL_STATE
OID_WWAN_SIGNAL_STATE возвращает или задает текущее состояние сигнала.
Драйверы мини-порта должны обрабатывать запросы set и запросов асинхронно, сначала возвращая 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 , даже если устройство в настоящее время не зарегистрировано ни в одном операторе и что любое ограничение, наложенное устройством в параметрах, может быть возможно только после регистрации. Драйвер мини-порта должен попытаться применить эти параметры в следующей доступной ситуации.
Выполните запрос успешно, если состояние аппаратного или программного переключателя радиопереключения в настоящее время находится в состоянии OFF. Драйвер минипорта кэшировал данные запроса и начал сообщать о силе сигнала после включения переключателя.
Может завершиться сбоем этого запроса с соответствующим набором кода ошибки uStatus .
При обработке запросов от службы MB драйверы miniport могут выполнять следующие действия:
Возвращает текущие значения 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
Начиная с Windows 10 версии 1903, OID_WWAN_SIGNAL_STATE обновлен до версии 3. Эта редакция позволяет узлу запрашивать новые значения мощности получения эталонного сигнала (RSRP) и сигнала к шуму (SNR) из драйвера мини-порта. Драйвер мини-порта должен использовать редакцию 3 этого объекта OID и его структуры данных, если драйвер поддерживает 5G.
Дополнительные сведения о поддержке классов данных 5G см. в разделе Mb 5G Data Class Support.
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (включая Ndis.h) |