Compartilhar via


OID_WWAN_REGISTER_STATE

OID_WWAN_REGISTER_STATE seleciona um provedor de rede com o qual se registrar.

Os drivers de miniport devem processar solicitações de definição e consulta de forma assíncrona, inicialmente retornando NDIS_STATUS_INDICATION_REQUIRED para a solicitação original e, posteriormente, enviando uma notificação de status NDIS_STATUS_WWAN_REGISTER_STATE contendo uma estrutura NDIS_WWAN_REGISTRATION_STATE para fornecer informações sobre o provedor de rede registrado, independentemente de concluir solicitações definidas ou de consulta.

Os chamadores que solicitam definir o provedor de rede para se registrar fornecem uma estrutura NDIS_WWAN_SET_REGISTER_STATE para o driver de miniporto com as informações apropriadas.

Observações

Para obter mais informações sobre como usar essa OID, consulte operações de registro do WWAN.

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

O modelo de driver MB dá suporte a dois métodos de registro: automático e manual. Para redes baseadas em CDMA, o modelo de driver MB dá suporte apenas ao registro automático.

Os dispositivos que dão suporte ao registro manual devem definir o membro WwanControlCaps na estrutura WWAN_DEVICE_CAPS para WWAN_CTRL_CAPS_REG_MANUAL. Lembre-se de que os dispositivos baseados em GSM devem dar suporte ao registro manual.

Se o estado de registro for automático, os drivers de miniporto deverão instruir seu dispositivo a selecionar um provedor de rede com base no algoritmo de seleção específico para a tecnologia de celular e continuar com o registro.

A semântica dos valores RegisterAction é definida da seguinte maneira:

  • O sinalizador WwanRegisterActionAutomatic é usado pelo Serviço MB para instruir o driver de miniporto a definir o dispositivo para o modo de registro automático e permitir que o dispositivo selecione a melhor rede de provedor. O driver de miniporto deve ignorar parâmetro ProviderId. Essa configuração é persistente entre estados de rádio (ON/OFF) e ciclos de energia do dispositivo, até que seja explicitamente alterada pelo Serviço MB.

  • O sinalizador WwanRegisterActionManual é usado pelo Serviço MB para instruir o driver de miniporto a se registrar na rede do provedor identificada pelo parâmetro ProviderId. O valor ProviderId deve vir do ProviderId membro da estrutura de dados WWAN_PROVIDER de um dos provedores visíveis. Essa configuração é persistente entre estados de rádio (ON/OFF) e ciclos de energia do dispositivo, até que seja explicitamente alterada pelo Serviço MB.

  • A alteração entre os diferentes valores de RegisterAction é permitida mesmo se o dispositivo estiver registrado no momento em um provedor. Se o dispositivo precisar desregister antes de alternar entre os modos de registro Automático e Manual, o driver de miniporto deverá garantir que o dispositivo esteja definido para desregistração antes de definir para o novo modo de registro.

  • O Manual e o modo de registro de Automático afeta apenas o modo de seleção de rede. O dispositivo MB deve tentar se registrar na rede selecionada sempre que o rádio estiver ativado.

Windows 10, versão 1903

Há suporte para uma nova revisão 3 para essa OID a partir do Windows 10, versão 1903. Essa extensão permite que o host consulte as RATs (tecnologias de acesso de rádio) preferenciais do driver de miniporto.

Para controlar o RAT preferencial, o host define uma máscara de bits representando valores WWAN_DATA_CLASS no membro do WwanDataClass da estrutura WWAN_SET_REGISTER_STATE. Esse membro representa as tecnologias de acesso a dados que são preferenciais para uma conexão. Se esse campo estiver definido como WWAN_DATA_CLASS_NONE, o modem não deverá executar nenhuma ação para esse parâmetro.

O host também pode consultar as classes de dados preferenciais no momento do driver de miniporto. O driver de miniporto usa o campo PreferredDataClasses da estrutura WWAN_REGISTRATION_STATE para relatar as tecnologias de acesso a dados preferenciais definidas no momento no modem.

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.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_WWAN_SET_REGISTER_STATE

NDIS_STATUS_WWAN_REGISTER_STATE

de operações de registro do WWAN