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

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.

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.

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

Confira também

IMbnSignal