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
S_OK	O método foi concluído com êxito .
E_PENDING	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

Confira também

IMbnSignal