OID_WWAN_SIGNAL_STATE

OID_WWAN_SIGNAL_STATE devuelve o establece el estado de señal actual.

Los controladores de miniport 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_SIGNAL_STATE que contiene una estructura de NDIS_WWAN_SIGNAL_STATE para proporcionar información sobre la indicación de estado de señal actual que se muestra al usuario final, independientemente de completar las solicitudes establecidas o de consulta.

Los autores de llamadas que solicitan establecer la indicación de estado de señal actual para el usuario final proporcionan una estructura de NDIS_WWAN_SET_SIGNAL_INDICATION al controlador de miniporte con la información adecuada.

Observaciones

Para obtener más información sobre el uso de este OID, consulte Operaciones de fuerza de señal WWAN.

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.

Por lo general, se debe indicar el estado de señal en lugar de sondear. Sin embargo, este OID está disponible en caso de que el estado de señal actual deba determinarse por el servicio MB.

Para responder a las solicitudes de consulta, los controladores de minipuerto deben enviar una notificación de NDIS_STATUS_WWAN_SIGNAL_STATE.

En una solicitud establecida del servicio MB, los controladores de minipuerto deben:

• Devuelve los valores actuales de Rssi y ErrorRate en la estructura de NDIS_WWAN_SIGNAL_STATE además de notificar los valores absolutos de RssiInterval y RssiThreshold que se han establecido en el controlador de miniport.

• Almacene internamente en caché los valores RssiInterval o RssiThreshold incluso si el dispositivo no está registrado actualmente con ningún operador y que cualquier restricción impuesta por el dispositivo en los parámetros de configuración solo puede ser posible después del estado de registro. El controlador de minipuerto debe intentar aplicar esta configuración en la siguiente situación disponible inmediata.

• Complete la solicitud correctamente, si el estado del conmutador de radio de hardware o software está desactivado actualmente. El controlador miniporte almacena en caché los datos de solicitud y comienza a notificar la intensidad de la señal después de activar el conmutador.

• Puede producir un error en esta solicitud con el código de error uStatus adecuado establecido.

Los controladores de minipuerto pueden hacer lo siguiente al procesar solicitudes de consulta desde el servicio MB:

• Devuelve los valores actuales de Rssi y ErrorRate en la estructura de NDIS_WWAN_SIGNAL_STATE además de notificar los valores absolutos de RssiInterval y RssiThreshold que se han establecido en el controlador de miniport.

• Produzca un error en esta solicitud con el código de error uStatus adecuado establecido.

Valores devueltos:

NDIS_STATUS_NOT_SUPPORTED

Los controladores miniport pueden devolver esto para dispositivos específicos que son conscientes de las funcionalidades del dispositivo que no admiten la intensidad de la señal pueden producir un error en la solicitud con este código de error.

Implementación recomendada

1. Los dispositivos deben admitir indicaciones de intensidad de señal.

2. Los conductores deben notificar indicaciones de intensidad de señal de al menos el 50 % de la configuración rssiInterval durante un período de tiempo de cinco minutos.

3. Los dispositivos deben evitar notificar la intensidad de la señal en los estados siguientes:

   1. El dispositivo no está registrado o se ha anulado y solo es aplicable para dispositivos GSM.

   2. El estado efectivo de la radio es OFF.

   3. En los estados anteriores, el controlador de minipuerto debe devolver una consulta a la intensidad de la señal con los siguientes datos:

      Rssi = WWAN_RSSI_UNKNOWN

      ErrorRate = WWAN_ERROR_RATE_UNKNOWN;

      RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT o último valor establecido>

      RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT o el último valor establecido>

Windows 10, versión 1903

A partir de Windows 10, versión 1903, OID_WWAN_SIGNAL_STATE se ha actualizado a la revisión 3. Esta revisión permite al host consultar los nuevos valores de potencia recibida de señal de referencia (RSRP) y señal a ruido (SNR) desde el controlador de minipuerto. Un controlador de minipuerto debe usar la revisión 3 de este OID y sus estructuras de datos si el controlador admite 5G.

Para obtener más información sobre la compatibilidad con clases de datos 5G, consulta Compatibilidad con clases de datos mb 5G.

Requisitos

Versión	Disponible en Windows 7 y versiones posteriores de Windows.
Encabezado	Ntddndis.h (include Ndis.h)

Consulte también

NDIS_WWAN_SET_SIGNAL_INDICATION

Operaciones de intensidad de señal WWAN