Método IMbnSignal::GetSignalStrength (mbnapi.h)
Importante
A partir do 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 intensidade do sinal recebida pelo dispositivo.
Sintaxe
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
Parâmetros
[out, retval] signalStrength
Ponteiro para a qualidade do sinal recebida pelo dispositivo. Quando a intensidade do sinal não é conhecida ou não é detectável pelo dispositivo, isso é definido como MBN_RSSI_UNKNOWN. Se esse método retornar qualquer valor diferente de S_OK, esse parâmetro será 0.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
A qualidade do sinal não está disponível. O serviço de Banda Larga Móvel está atualmente investigando o dispositivo para recuperar essas informações. Quando a qualidade do sinal estiver disponível, o serviço de Banda Larga Móvel chamará o método OnSignalStateChange de IMbnSignalEvents. |
Comentários
GetSignalStrength relata a intensidade do sinal recebida pelo dispositivo de Banda Larga Móvel. Para dispositivos baseados em GSM, ele relata a intensidade do sinal como força do sinal recebida em um valor codificado. Para dispositivos CDMA, ele relata com base no RSSI compensado (conta para ruído) e não com base no RSSI bruto.
A tabela a seguir contém os valores codificados que podem ser retornados.
| Intensidade do sinal (no dBm) | Valor codificado (mínimo: 0 máx. 31) |
|---|---|
| -113 ou menos | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| ... | ... |
| -51 ou superior | 31 |
| Desconhecido ou indetectável | MBN_RSSI_UNKNOWN |
Para erros recuperáveis E_MBN_PIN_REQUIRED e E_MBN_RADIO_POWER_OFF, o serviço de Banda Larga Móvel consultará o dispositivo novamente para obter o estado do sinal quando a condição de erro terminar. Esse método retornará E_PENDING até que a operação de consulta seja concluída. Quando a nova consulta for concluída, o serviço de Banda Larga Móvel chamará o método OnSignalStateChange de IMbnSignalEvents.
Requisitos
| 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 |