Método IMbnSignal::GetSignalStrength (mbnapi.h)
Importante
A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.
Obtiene la intensidad de señal recibida por el dispositivo.
Sintaxis
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
Parámetros
[out, retval] signalStrength
Puntero a la calidad de señal recibida por el dispositivo. Cuando el dispositivo no conoce la intensidad de la señal o el dispositivo no lo detecta, se establece en MBN_RSSI_UNKNOWN. Si este método devuelve cualquier valor distinto de S_OK, este parámetro es 0.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
|
La calidad de la señal no está disponible. Actualmente, el servicio de banda ancha móvil está sondeando el dispositivo para recuperar esta información. Cuando la calidad de la señal esté disponible, el servicio de banda ancha móvil llamará al método OnSignalStateChange de IMbnSignalEvents. |
Comentarios
GetSignalStrength informa de la intensidad de la señal recibida por el dispositivo de banda ancha móvil. En el caso de los dispositivos basados en GSM, notifica la intensidad de la señal como intensidad de señal recibida en un valor codificado. En el caso de los dispositivos ADVISOR, notifica en función del RSSI compensado (cuenta el ruido) y no en función de RSSI sin procesar.
La tabla siguiente contiene los valores codificados que se pueden devolver.
| Intensidad de señal (en dBm) | Valor codificado (min: 0 max: 31) |
|---|---|
| -113 o menos | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| ... | ... |
| -51 o superior | 31 |
| Desconocido o no detectable | MBN_RSSI_UNKNOWN |
En el caso de los errores recuperables E_MBN_PIN_REQUIRED y E_MBN_RADIO_POWER_OFF, el servicio de banda ancha móvil consultará de nuevo el dispositivo para obtener el estado de la señal cuando se supere la condición de error. Este método devolverá E_PENDING hasta que se complete la operación de consulta. Una vez completada la nueva consulta, el servicio de banda ancha móvil llamará al método OnSignalStateChange de IMbnSignalEvents.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | mbnapi.h |