OID_WWAN_CONNECT
OID_WWAN_CONNECT ativa ou desativa um contexto de pacote específico e lê o estado de ativação de um contexto.
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_CONTEXT_STATE contendo uma estrutura de NDIS_WWAN_CONTEXT_STATE que indica o estado de contexto do protocolo PDP (Packet Data Protocol) do dispositivo MB, independentemente de concluir solicitações de conjunto ou consulta.
Os chamadores que solicitam definir o estado de contexto do protocolo PDP (Packet Data Protocol) do dispositivo MB fornecem uma estrutura NDIS_WWAN_SET_CONTEXT_STATE ao driver de miniporta com as informações apropriadas.
Comentários
Para obter mais informações sobre como usar esse OID, consulte WWAN Packet Context Management.
Este objeto ativa ou desativa um contexto de pacote específico e lê o estado de ativação de um contexto. O driver de miniporta deve enviar notificações de eventos apropriadas sempre que o estado de ativação mudar.
Este objeto é chamado somente se o driver de miniporta estiver em um estado de registro de WwanRegisterStateHome, WwanRegisterStatePartnerou WwanRegisterStateRoaming. Quando o serviço de pacotes está ativo, o dispositivo também deve estar em um estado de anexação de WwanPacketServiceStateAttached.
As operações de conjunto e consulta são suportadas para este objeto.
O processamento de uma solicitação definida requer acesso à rede, mas não acesso ao SIM.
O processamento de uma solicitação de consulta não requer acesso à rede ou ao SIM.
A estrutura de dados para este OID é NDIS_WWAN_SET_CONTEXT_STATE. O driver de miniporta emite uma indicação de status de NDIS_STATUS_WWAN_CONTEXT_STATE para solicitações de conjunto e consulta.
Nesta versão do modelo de driver, o driver de miniporta tenta a ativação de contexto somente conforme instruído pelo Serviço MB. (Os drivers de miniporta podem ativar um contexto iniciado pela rede em versões posteriores.) Os drivers de miniporta não devem ativar automaticamente um contexto, mesmo depois de perder o registro ou um sinal. Se a cadeia de caracteres de acesso não for fornecida na solicitação de ativação, um driver de miniporta não deverá tentar fornecer uma cadeia de caracteres padrão. Em vez disso, ele deve continuar ativando o contexto com uma cadeia de caracteres de acesso em branco.
Por outro lado, o driver de miniporta pode desativar um contexto conforme instruído pelo serviço MB. Isso pode ocorrer quando a conectividade de rede foi perdida por um período que excede o limite de perda temporária de sinal, ou como parte de um desligamento normal ou limpeza de estado.
Como apenas um contexto ativado é suportado nesta versão, ativar ou desativar um contexto específico equivale a configurar ou derrubar a conexão de camada de 2 MB.
Em solicitações definidas, o serviço MB fornece ConnectionId e parâmetros ActivationCommand na estrutura de dados WWAN_CONTEXT_STATE. Ele instrui o driver de miniporta a ativar ou desativar um contexto de pacote identificado por ConnectionId, com base no valor do parâmetro ActivationCommandWwanActivationCommandActivate ou WwanActivationCommandDeactivate.
Se o serviço ou a assinatura exigir ativação, o driver da miniporta deverá retornar o código de erro WWAN_STATUS_SERVICE_NOT_ACTIVATED. A ativação do PDP pode não acontecer até que o serviço ou a assinatura sejam ativados. Todos os serviços de emergência podem estar disponíveis mediante o apoio do dispositivo e do operador. O sistema operacional pode chamar o OID_WWAN_SERVICE_ACTIVATION em resposta a esse código de erro.
Se o driver de miniporta receber uma solicitação de ativação de contexto enquanto outro contexto de pacote estiver ativado no momento, ele retornará o código de erro WWAN_STATUS_MAX_ACTIVATED_CONTEXTS.
Se o driver de miniporta receber uma solicitação de desativação de contexto, mas o contexto identificado por ConnectionId não estiver ativado no momento, ele retornará o código de erro WWAN_STATUS_CONTEXT_NOT_ACTIVATED.
O driver de miniporta usa a seguinte lógica para determinar a validade das configurações AccessString, UserName e Password a partir de uma solicitação definida:
- Se ActivationCommand estiver WwanActivationCommandDeactivate, o driver de miniporta deve ignorar as configurações desses três parâmetros. O resto dos casos só considera o caso quando ActivationCommand é WwanActivationCommandActivate.
A ativação de contexto persiste no logon e no logoff do usuário. Não é por usuário de logon.
Em solicitações de consulta, o Serviço MB usa esse objeto para descobrir o estado de ativação.
Para responder a solicitações de consulta, o driver de miniporta envia a notificação de NDIS_STATUS_WWAN_CONTEXT_STATE.
Nota importante:
Em circunstâncias raras, mas específicas, o Serviço MB no Windows 7 pode tentar conectar-se automaticamente antes que a conectividade com a Internet tenha sido determinada para conexões pré-existentes ou durante uma interrupção momentânea na conectividade com a Internet de conexões pré-existentes. Isso pode resultar em conexões simultâneas MB e WLAN/Ethernet. Por exemplo, isso pode ocorrer durante a inicialização do sistema quando MB e outras conexões são tentadas simultaneamente e o serviço Network List Manager ainda está tentando determinar a conectividade com a Internet de outras conexões usando métodos ativos e passivos. Também pode ocorrer devido a interrupções temporárias na infraestrutura de rede, como um servidor proxy corporativo ou uma rede ISP. Assim, o Serviço MB pode tentar ligar-se automaticamente à Internet independentemente de a opção "Ligar automaticamente apenas se não estiver disponível uma ligação alternativa à Internet".
Requerimentos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |