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 miniporto 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 um NDIS_STATUS_WWAN_RADIO_STATE status notificação contendo uma estrutura NDIS_WWAN_RADIO_STATE que indica o estado de energia de rádio atual do dispositivo MB, independentemente de concluir solicitações de definição 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 para o driver de miniporto com as informações apropriadas.

Comentários

Para obter mais informações sobre como usar esse OID, consulte Estado da Rádio MB.

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.

Os drivers de miniport devem manter os estados de energia de rádio de software na reinicialização do sistema ou na remoção e reinserção do dispositivo. Os drivers de miniporta devem armazenar as informações de rádio de software do dispositivo e usá-la para definir o estado de energia de rádio do software do dispositivo imediatamente em cada reinicialização ou reinserção do dispositivo. O estado efetivo de energia de rádio do dispositivo é decidido com base na combinação do estado de energia de rádio de software e hardware de acordo com a tabela em WWAN_RADIO_STATE.

Se o valor for WwanRadioOn, os drivers de miniporto deverão ativar a energia de rádio e definir o membro RadioState.SwRadioState da estrutura WWAN_RADIO_STATE como WwanRadioOn. Se o membro RadioState.HwRadioState era WwanRadioOff, os drivers de miniport devem armazenar em cache essas informações de estado de energia e garantir a ativação física do estado de energia de rádio quando RadioState.HwRadioState for alterado para WwanRadioOn.

Se o valor for WwanRadioOff, os drivers de miniporto deverão desativar o estado de energia de rádio e definir o membro RadioState.SwRadioState como WwanRadioOff.

Consulte a tabela a seguir para 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 de HwRadioState	Valor de SwRadioState	Estado geral de energia de rádio
WwanRadioOff	WwanRadioOff	WwanRadioOff
WwanRadioOff	WwanRadioOn	WwanRadioOff
WwanRadioOn	WwanRadioOff	WwanRadioOff
WwanRadioOn	WwanRadioOn	WwanRadioOn

Para dispositivos que não fornecem um comutador de energia de rádio de hardware, o membro RadioState.HwRadioState da estrutura NDIS_WWAN_RADIO_STATE sempre deve ser definido como WwanRadioOn.

A partir do Windows 10, versão 1703, OID_WWAN_RADIO_STATE tem especificações adicionais sobre como um modem com suporte de vários executores deve lidar com a configuração de estado de rádio do sistema operacional.

Com um modem com suporte para vários executores, há benefícios de energia para configurar o estado de energia de rádio por executor. Quando o rádio de um executor é desativado, o sistema operacional espera que o modem desative o registro da rede e não tente nenhuma verificação ou atualização de local dele. O modem deve dar suporte a um estado de rádio para cada executor que ele anuncia para o sistema operacional para que ele possa determinar o estado de energia de hardware no qual ele deve ser.

Por exemplo, se o modem tiver dois executores e um do rádio dos executores estiver desativado enquanto o outro estiver ativado, o modem poderá manter o front-end rf ligado para manter o registro no executor cujo rádio está ativado, mas não precisa fazer atualizações de verificação/ping/local ou outros serviços de celular para o executor que está desativado. Se ambos os rádios estiverem desativados, o modem poderá desativar seu front-end RF e levar o hardware geral para um estado de energia mais baixo. As especificações de implementação são deixadas para cada IHV.

Requisitos

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

Confira também

NDIS_WWAN_RADIO_STATE

NDIS_WWAN_SET_RADIO_STATE

NDIS_STATUS_WWAN_RADIO_STATE

Estado da Rádio MB

WWAN_RADIO_STATE