Compartilhar via

Método IMbnSignal::GetSignalStrength (mbnapi.h)

  • Artigo

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

Confira também

IMbnSignal