OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE establece o devuelve información sobre el estado de energía de radio de un dispositivo MB.
Los controladores de minipuerto deben procesar las solicitudes de establecimiento y consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original y, posteriormente, enviando una notificación de estado de NDIS_STATUS_WWAN_RADIO_STATE que contiene una estructura de NDIS_WWAN_RADIO_STATE que indica el estado actual de energía de radio del dispositivo MB, independientemente de completar las solicitudes de consulta o conjuntos.
Los autores de llamadas que solicitan establecer el estado de energía de radio del dispositivo MB proporcionan una estructura de NDIS_WWAN_SET_RADIO_STATE al controlador de miniporte con la información adecuada.
Observaciones
Para obtener más información sobre el uso de este OID, vea MB Radio State.
Los controladores de minipuerto no deben acceder a la red del proveedor ni al módulo de identidad del suscriptor (tarjeta SIM), al procesar las operaciones de consulta o establecimiento.
Los controladores miniport deben conservar los estados de energía de radio de software en el reinicio del sistema o la eliminación y reinserción del dispositivo. Los controladores miniport deben almacenar la información de radio del software del dispositivo y usarlo para establecer el estado de energía de radio del software del dispositivo inmediatamente en cada reinicio o reinserción del dispositivo. El estado eficaz de energía de radio del dispositivo se decide en función de la combinación de software y estado de energía de radio de hardware según la tabla en WWAN_RADIO_STATE.
Si el valor es WwanRadioOn, los controladores de minipuerto deben activar la potencia de radio y establecer el miembro RadioState.SwRadioState de la estructura de WWAN_RADIO_STATE en WwanRadioOn. Si el miembro RadioState.HwRadioState era WwanRadioOff, los controladores de minipuerto deben almacenar en caché esta información de estado de energía y asegurarse de activar físicamente el estado de alimentación de radio cuando RadioState.HwRadioState cambia a WwanRadioOn.
Si el valor es WwanRadioOff, los controladores de minipuerto deben desactivar el estado de alimentación de radio y establecer el miembro RadioState.SwRadioState en WwanRadioOff.
Consulte la tabla siguiente para ver la programación de estado de radio esperada por los controladores de miniport.
Combinaciones válidas para el modo PIN y el estado del PIN
| Valor HwRadioState | Valor swRadioState | Estado general de energía de radio |
|---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
En el caso de los dispositivos que no proporcionan un conmutador de alimentación de radio de hardware, el miembro RadioState.HwRadioState de la estructura de NDIS_WWAN_RADIO_STATE siempre debe establecerse en WwanRadioOn.
A partir de Windows 10, versión 1703, OID_WWAN_RADIO_STATE tiene especificaciones adicionales sobre cómo un módem compatible con varios ejecutores debe controlar la configuración de estado de radio desde el sistema operativo.
Con un módem compatible con varios ejecutores, hay ventajas de energía para configurar el estado de energía de radio por ejecutor. Cuando la radio de un ejecutor está desactivada, el sistema operativo espera que el módem se desconscriba de la red y no intente realizar ningún examen ni actualizaciones de ubicación desde ella. El módem debe admitir un estado de radio para cada ejecutor que anuncia en el sistema operativo para que pueda determinar el estado de alimentación del hardware en el que debe estar.
Por ejemplo, si el módem tiene dos ejecutores y una de las radios de los ejecutores está apagada mientras la otra está activada, el módem puede mantener encendido el front-end rf para mantener el registro en el ejecutor cuya radio está activada, pero no necesita realizar exámenes, pinging/actualizaciones de ubicación u otros servicios móviles para el ejecutor que está desactivado. Si ambas radios están desactivadas, el módem puede apagar su front-end RF y llevar el hardware general a un estado de alimentación inferior. Los detalles de implementación quedan a cada IHV.
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ntddndis.h (include Ndis.h) |