OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE задает или возвращает сведения о состоянии питания устройства в МБ.
Драйверы мини-порта должны обрабатывать запросы set и query в асинхронном режиме, изначально возвращая NDIS_STATUS_INDICATION_REQUIRED в исходный запрос, а затем отправляя уведомление о состоянии NDIS_STATUS_WWAN_RADIO_STATE , содержащее структуру NDIS_WWAN_RADIO_STATE , которая указывает текущее состояние питания устройства в МБ независимо от завершения задания или запроса.
Вызывающие абоненты, запрашивающие настройку состояния питания устройства в МБ, предоставляют драйверу мини-порта 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.SwRadioState значение WwanRadioOff.
Сведения об ожидаемом программировании состояния радиоперевозок драйверами минипорта см. в следующей таблице.
Допустимые сочетания для режима ПИН-кода и состояния ПИН-кода
Значение 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 содержит дополнительные спецификации, определяющие, как поддерживаемый несколькими исполнителями модем должен обрабатывать конфигурацию состояния радиосвязи из ОС.
При использовании модема с поддержкой нескольких исполнителей можно настроить состояние радиосвязи для каждого исполнителя. Если радиосвязь исполнителя отключена, ОПЕРАЦИОННая система ожидает, что модем будет снят с сети и не пытается выполнить сканирование или обновление расположения. Модем должен поддерживать состояние радио для каждого исполнителя, которое он объявляет операционной системе, чтобы определить состояние оборудования, в котором он должен находиться.
Например, если у модема есть два исполнителя и один из переключателей исполнителя выключен, а другой включен, модем может оставить радиочастотный интерфейс включенным для поддержания регистрации исполнителя, радиосвязь которого включена, но не требуется выполнять сканирование, проверку связи, определение местоположения или другие службы сотовой связи для исполнителя, который выключен. Если оба радиомодуля отключены, модем может отключить свой радиочастотный интерфейс и перевести общее оборудование в более низкое состояние питания. Особенности реализации предоставляются каждому IHV.
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (включая Ndis.h) |