OID_WWAN_SIGNAL_STATE

OID_WWAN_SIGNAL_STATE retorna ou define o estado atual do sinal.

Os drivers de miniporta devem processar solicitações de conjunto e consulta de forma assíncrona, inicialmente retornando NDIS_STATUS_INDICATION_REQUIRED à solicitação original e, posteriormente, enviando uma notificação de status de NDIS_STATUS_WWAN_SIGNAL_STATE contendo uma estrutura de NDIS_WWAN_SIGNAL_STATE para fornecer informações sobre a indicação atual do estado do sinal mostrada ao usuário final, independentemente de concluir solicitações de conjunto ou consulta.

Os chamadores que solicitam definir a indicação do estado do sinal atual para o usuário final fornecem uma estrutura de NDIS_WWAN_SET_SIGNAL_INDICATION ao driver da miniporta com as informações apropriadas.

Comentários

Para obter mais informações sobre como usar esse OID, consulte WWAN Signal Strength Operations.

Os drivers de miniporta não devem acessar a rede do provedor ou o Módulo de Identidade do Assinante (cartão SIM) ao processar consultas ou definir operações.

Geralmente, o estado do sinal deve ser indicado em vez de sondado. No entanto, este OID é disponibilizado caso o estado atual do sinal precise ser determinado pelo serviço MB.

Para responder a solicitações de consulta, os drivers de miniporta devem enviar uma notificação de NDIS_STATUS_WWAN_SIGNAL_STATE.

Em uma solicitação definida do Serviço MB, os drivers de miniporta devem:

• Retorne os valores atuais para Rssi e ErrorRate na estrutura NDIS_WWAN_SIGNAL_STATE, além de relatar os valores absolutos para RssiInterval e RssiThreshold que foi definido no driver de miniporta.

• Armazene internamente em cache os valores de RssiInterval e/ou RssiThreshold, mesmo que o dispositivo não esteja atualmente registrado em nenhum operador e que qualquer restrição imposta pelo dispositivo na definição de parâmetros só possa ser possível após o registro. O driver de miniporta deve tentar aplicar essas configurações na próxima situação disponível imediata.

• Conclua a solicitação com êxito, se o estado do interruptor de rádio de hardware e/ou software estiver desativado no momento. O driver de miniporta armazena em cache os dados da solicitação e começa a relatar a intensidade do sinal depois que o switch é ligado.

• Pode falhar esta solicitação com o apropriado uStatus código de erro definido.

Os drivers de miniporta podem fazer o seguinte ao processar solicitações de consulta do Serviço MB:

• Retorne os valores atuais para Rssi e ErrorRate na estrutura NDIS_WWAN_SIGNAL_STATE, além de relatar os valores absolutos para RssiInterval e RssiThreshold que foi definido no driver de miniporta.

• Falha nesta solicitação com o apropriado uStatus código de erro definido.

Valores de retorno:

NDIS_STATUS_NOT_SUPPORTED

Os drivers de miniporta podem retornar isso para dispositivos específicos que estão cientes dos recursos do dispositivo que não suportam a intensidade do sinal podem falhar a solicitação com esse código de erro.

Implementação recomendada

1. Os dispositivos devem suportar indicações da intensidade do sinal.

2. Os condutores devem comunicar as indicações da intensidade do sinal de, pelo menos, 50% da regulação do RssiInterval durante um período de tempo de cinco minutos.

3. Os dispositivos devem evitar comunicar a intensidade do sinal nos seguintes estados:

   1. Dispositivo não registado ou cancelado e aplica-se apenas a dispositivos GSM.

   2. O estado efetivo do rádio está desligado.

   3. Nos estados acima, uma consulta à intensidade do sinal deve ser retornada com os seguintes dados pelo driver de miniporta:

      Rssi = WWAN_RSSI_UNKNOWN

      ErrorRate = WWAN_ERROR_RATE_UNKNOWN;

      RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT ou último valor definido>

      RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT ou o último valor definido>

Windows 10, versão 1903

A partir do Windows 10, versão 1903, OID_WWAN_SIGNAL_STATE foi atualizado para a revisão 3. Essa revisão permite que o host consulte novos valores de potência recebida de sinal de referência (RSRP) e Signal-to-Noise (SNR) do driver de miniporta. Um driver de miniporta deve usar a revisão 3 deste OID e suas estruturas de dados se o driver suportar 5G.

Para obter mais informações sobre o suporte de classe de dados 5G, consulte MB de suporte de classe de dados 5G.

Requerimentos

Versão	Disponível no Windows 7 e versões posteriores do Windows.
Cabeçalho	Ntddndis.h (inclui Ndis.h)

Ver também

NDIS_WWAN_SET_SIGNAL_INDICATION

de Operações de Força do Sinal WWAN