OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE задает или возвращает сведения о состоянии радиосвязи устройства МБ.
Драйверы минипорта должны обрабатывать и запрашивать запросы асинхронно, первоначально возвращая NDIS_STATUS_INDICATION_REQUIRED исходному запросу, а затем отправлять уведомление о состоянии NDIS_STATUS_WWAN_RADIO_STATE, содержащее структуру NDIS_WWAN_RADIO_STATE, которая указывает текущее состояние питания устройства MB независимо от завершения набора или запроса.
Вызывающие абоненты, запрашивающие задать состояние радиопередаки устройства МБ, предоставляют NDIS_WWAN_SET_RADIO_STATE структуру минипорта драйверу с соответствующими сведениями.
Замечания
Дополнительные сведения об использовании этого OID см. в MB Radio State.
Драйверы мини-порта не должны обращаться к сети поставщика или модулю удостоверений подписчика (SIM-карта), при обработке запросов или задания операций.
Мини-порты должны сохранять состояния программного обеспечения радиопередачи во время перезагрузки системы или удаления устройства и повторного восстановления. Драйверы минипорта должны хранить программные радиоинформативные данные устройства и использовать его для настройки состояния программного обеспечения радиопередаки устройства немедленно при каждом перезапуске или повторном включении устройства. Эффективное состояние радиосвязи устройства определяется на основе сочетания состояния программного обеспечения и аппаратного радиопередающего питания в соответствии с таблицей в WWAN_RADIO_STATE.
Если значение равно WwanRadioOn, драйверы минипорта должны включить радиосвязь и задать RadioState.SwRadioState член структуры WWAN_RADIO_STATE WwanRadioOn. Если RadioState.HwRadioState был WwanRadioOff, минипорт-драйверы должны кэшировать эту информацию о состоянии питания и обеспечить физическое включение состояния радио, когда RadioState.HwRadioState изменения в WwanRadioOn.
Если значение равно WwanRadioOff, драйверы минипорта должны отключить состояние радиопередачи и задать элемент RadioState.SwRadioStateWwanRadioOff.
См. следующую таблицу для ожидаемого программирования радиосочета с помощью минипорт-драйверов.
допустимые сочетания для режима ПИН-кода и состояния ПИН-кода
Значение HwRadioState | Значение SwRadioState | Общее состояние радиосвязи |
---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
Для устройств, которые не предоставляют аппаратный переключатель питания, RadioState.HwRadioState элемент структуры NDIS_WWAN_RADIO_STATE всегда должен иметь значение WwanRadioOn.
Начиная с Windows 10 версии 1703, OID_WWAN_RADIO_STATE содержит дополнительные спецификации для обработки конфигурации состояния радио из ОС, поддерживаемой несколькими исполнителями модема.
С поддержкой многофакторного модема существуют преимущества питания для настройки состояния радиосвязи для каждого исполнителя. Если переключатель исполнителя отключен, операционная система ожидает, что модем будет дерегистрироваться из сети и не пытается выполнять проверку или обновление расположения. Модем должен поддерживать состояние радио для каждого исполнителя, которое оно объявляет ос, чтобы определить аппаратное состояние питания, в котором он должен быть.
Например, если модем имеет двух исполнителей и один из исполнителей радио отключен, а другой включен, модем может сохранить интерфейс RF, чтобы поддерживать регистрацию на исполнителе, радио которого включен, но не требуется выполнять сканирование/ проверку или подключение к расположению или другие мобильные службы для исполнителя, который отключен. Если оба радио отключены, модем может отключить внешний интерфейс RF и привести общее оборудование к более низкому состоянию питания. Особенности реализации остаются для каждого IHV.
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (include Ndis.h) |