Método IMbnSignal::GetSignalError (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 tasa de errores de señal recibida.
Sintaxis
HRESULT GetSignalError(
[out, retval] ULONG *signalError
);
Parámetros
[out, retval] signalError
Puntero a la tasa de errores de la señal recibida.
Las interfaces de banda ancha móvil notifican la tasa de errores de señal como un valor codificado que se asigna al intervalo de porcentajes de tasas de error. Esta es la tasa de errores de bits de canal para GSM y velocidad de error de fotogramas para FONO. En ambos casos, MBN_ERROR_RATE_UNKNOWN especifica una tasa de errores desconocida.
En la tabla siguiente se muestran los valores de los códigos de tasa de error.
| Velocidad de error de bits (en %) | Velocidad de error de fotogramas (en %) | Valor codificado (0-7) |
|---|---|---|
| < 0.2 | < 0.01 | 0 |
| 0.2 - 0.4 | 0.01 - 0.1 | 1 |
| 0.4 - 0.8 | 0.1 - 0.5 | 2 |
| 0.8 - 1.6 | 0.5 - 1.0 | 3 |
| 1.6 - 3.2 | 1.0 - 2.0 | 4 |
| 3.2 - 6.4 | 2.0 - 4.0 | 5 |
| 6.4 - 12.8 | 4.0 - 8.0 | 6 |
| > 12.8 | > 8.0 | 7 |
| unknown | unknown | MBN_ERROR_RATE_UNKNOWN |
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. . |
|
La tasa de errores aún no está disponible. El servicio de banda ancha móvil está sondeando el dispositivo para recuperar la información. Cuando la tasa de errores esté disponible, el servicio de banda ancha móvil llamará al método OnSignalStateChange de IMbnSignalEvents. |
Comentarios
Las interfaces de banda ancha móvil notifican la tasa de errores de señal como un valor codificado que se asigna a un intervalo porcentual de tasas de error. Esta es la tasa de errores de bits de canal para GSM y velocidad de error de fotogramas para FONO. En ambos casos, MBN_ERROR_RATE_UNKNOWN especifica una tasa de errores desconocida.
Requisitos
| Requisito | Value |
|---|---|
| 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 |