Поделиться через


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)

См. также

NDIS_WWAN_RADIO_STATE

NDIS_WWAN_SET_RADIO_STATE

NDIS_STATUS_WWAN_RADIO_STATE

MB Radio State

WWAN_RADIO_STATE