Share via

OID_WWAN_SIGNAL_STATE

  • Artigo

OID_WWAN_SIGNAL_STATE retorna ou define o estado do sinal atual.

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

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

Comentários

Para obter mais informações sobre como usar esse OID, consulte Operações de força do sinal WWAN.

Os drivers de miniporto não devem acessar a rede do provedor ou o Sim Cartão (Módulo de Identidade do Assinante), ao processar operações de consulta ou de definição.

Em geral, o estado do sinal deve ser indicado em vez de sondado. No entanto, esse OID é disponibilizado caso o estado do sinal atual precise ser determinado pelo Serviço MB.

Para resposta a solicitações de consulta, os drivers de miniporto 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 foram definidos no driver de miniporto.

  • Armazene em cache internamente os valores RssiInterval e/ou RssiThreshold mesmo que o dispositivo não esteja registrado no momento com nenhum operador e que qualquer restrição imposta pelo dispositivo na configuraçã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 comutador de rádio de hardware e/ou software estiver desativado no momento. O driver de miniporta armazena os dados da solicitação em cache e começa a relatar a intensidade do sinal depois que o comutador é ativado.

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

Os drivers de miniport 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 foram definidos no driver de miniporto.

  • Falha nessa solicitação com o conjunto de códigos de erro uStatus apropriado.

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 dão suporte à intensidade do sinal podem falhar na solicitação com esse código de erro.

Implementação recomendada

  1. Os dispositivos devem dar suporte a indicações de intensidade de sinal.

  2. Os drivers devem relatar indicações de força de sinal de pelo menos 50% da configuração RssiInterval durante um período de cinco minutos.

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

    1. Dispositivo não registrado ou desregistrado e é aplicável somente para dispositivos GSM.

    2. O estado efetivo do rádio é OFF.

    3. Nos estados acima, uma consulta para a 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 RSRP (energia recebida do sinal de referência) e SNR (sinal para ruído) do driver de miniporta. Um driver de miniporta deve usar a revisão 3 desse OID e suas estruturas de dados se o driver der suporte a 5G.

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

Requisitos

Versão

Disponível no Windows 7 e versões posteriores do Windows.

parâmetro

 Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_WWAN_SET_SIGNAL_INDICATION

Operações de força do sinal WWAN