Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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) |