OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE define ou retorna informações sobre o estado de energia de rádio de um dispositivo MB.
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_RADIO_STATE contendo uma estrutura de NDIS_WWAN_RADIO_STATE que indica o estado atual de energia de rádio do dispositivo MB, independentemente da conclusão de solicitações de conjunto ou consulta.
Os chamadores que solicitam definir o estado de energia de rádio do dispositivo MB fornecem uma estrutura NDIS_WWAN_SET_RADIO_STATE ao driver de miniporta com as informações apropriadas.
Comentários
Para obter mais informações sobre como usar esse OID, consulte MB Radio State.
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.
Os drivers de miniporta devem manter os estados de energia de rádio do software durante a reinicialização do sistema ou a remoção e reinserção do dispositivo. Os drivers de miniporta devem armazenar as informações de rádio do software do dispositivo e usá-las para definir o estado de energia do rádio do software do dispositivo imediatamente em cada reinicialização ou reinserção do dispositivo. O estado efetivo de potência de rádio do dispositivo é decidido com base na combinação de software e hardware estado de energia de rádio de acordo com a tabela em WWAN_RADIO_STATE.
Se o valor for WwanRadioOn, os drivers de miniporta devem ligar a alimentação de rádio e definir o RadioState.SwRadioState membro da estrutura WWAN_RADIO_STATE para WwanRadioOn. Se o membro do RadioState.HwRadioState foi WwanRadioOff, os drivers de miniporta devem armazenar em cache essas informações de estado de energia e garantir que você ligue fisicamente o estado de energia de rádio quando RadioState.HwRadioState alterações para WwanRadioOn.
Se o valor for WwanRadioOff, os drivers de miniporta devem desativar o estado de energia de rádio e definir o RadioState.SwRadioState membro para WwanRadioOff.
Consulte a tabela a seguir para obter a programação de estado de rádio esperada por drivers de miniporta.
combinações válidas para o modo PIN e o estado do PIN
| Valor HwRadioState | Valor SwRadioState | Estado geral da potência de rádio |
|---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
Para dispositivos que não fornecem um interruptor de alimentação de rádio de hardware, o RadioState.HwRadioState membro da estrutura NDIS_WWAN_RADIO_STATE deve sempre ser definido como WwanRadioOn.
A partir do Windows 10, versão 1703, OID_WWAN_RADIO_STATE tem especificações adicionais sobre como um modem suportado por vários executores deve lidar com a configuração do estado de rádio do sistema operacional.
Com um modem suportado por vários executores, há benefícios de energia na configuração do estado de energia de rádio por executor. Quando o rádio de um executor é desligado, o sistema operacional espera que o modem cancele o registro da rede e não tenta nenhuma verificação ou atualizações de localização a partir dele. O modem deve suportar um estado de rádio para cada executor que anuncia para o SO para que possa determinar o estado de energia do hardware em que deve estar.
Por exemplo, se o modem tiver dois executores e um dos executores estiver desligado enquanto o outro estiver ligado, o modem poderá manter o front-end de RF ligado para manter o registro no executor cujo rádio está ligado, mas não precisa fazer atualizações de digitalização/ping/localização ou outros serviços celulares para o executor que está desligado. Se ambos os rádios estiverem desligados, o modem pode desligar o front-end de RF e levar o hardware geral a um estado de energia mais baixo. As especificidades da implementação são deixadas para cada IHV.
Requerimentos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |