Método IMbnSignal::GetSignalError (mbnapi.h)
Importante
A partir de Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Obtém a taxa de erro de sinal recebida.
Sintaxe
HRESULT GetSignalError(
[out, retval] ULONG *signalError
);
Parâmetros
[out, retval] signalError
Ponteiro para a taxa de erro no sinal recebido.
As Interfaces de Banda Larga Móvel relatam a taxa de erro de sinal como um valor codificado que mapeia para o intervalo percentual de taxas de erro. Essa é a taxa de erro de bit de canal para GSM e taxa de erro de quadro para CDMA. Em ambos os casos, MBN_ERROR_RATE_UNKNOWN especifica uma taxa de erro desconhecida.
A tabela a seguir mostra os valores dos códigos de taxa de erro.
| Taxa de erro de bit (em %) | Taxa de erro de quadro (em %) | Valor codificado (0 a 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 |
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com êxito . |
|
A taxa de erro ainda não está disponível. O serviço de Banda Larga Móvel está investigando o dispositivo para recuperar as informações. Quando a taxa de erro estiver disponível, o serviço de Banda Larga Móvel chamará o método OnSignalStateChange de IMbnSignalEvents. |
Comentários
As interfaces de banda larga móvel relatam a taxa de erro de sinal como um valor codificado que mapeia para um intervalo percentual de taxas de erro. Essa é a taxa de erro de bit de canal para GSM e taxa de erro de quadro para CDMA. Para ambos os casos, MBN_ERROR_RATE_UNKNOWN especifica uma taxa de erro desconhecida.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |