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 miniport devem processar solicitações de definição e consulta de forma assíncrona, retornando inicialmente NDIS_STATUS_INDICATION_REQUIRED para a solicitação original e, posteriormente, enviando uma notificação NDIS_STATUS_WWAN_CONTEXT_STATE status contendo uma estrutura NDIS_WWAN_CONTEXT_STATE que indica o estado de contexto PDP (Protocolo de Dados de Pacote) do dispositivo MB, independentemente de concluir solicitações de conjunto ou consulta.
Os chamadores que solicitam definir o estado de contexto PDP (Protocolo de Dados de Pacote) do dispositivo MB fornecem uma estrutura NDIS_WWAN_SET_CONTEXT_STATE para o driver de miniporto com as informações apropriadas.
Comentários
Para obter mais informações sobre como usar esse OID, consulte Gerenciamento de contexto de pacote WWAN.
Esse 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 evento apropriadas sempre que o estado de ativação for alterado.
Esse objeto será chamado somente se o driver de miniporto estiver em um estado de registro de WwanRegisterStateHome, WwanRegisterStatePartner ou WwanRegisterStateRoaming. Quando o serviço de pacote está ativo, o dispositivo também deve estar em um estado de anexação de WwanPacketServiceStateAttached.
As operações set e query são compatíveis com esse objeto.
O processamento de uma solicitação definida requer acesso à rede, mas não acesso sim.
O processamento de uma solicitação de consulta não requer acesso à rede nem ao SIM.
A estrutura de dados para esse OID é NDIS_WWAN_SET_CONTEXT_STATE. O driver de miniporta emite uma indicação status de NDIS_STATUS_WWAN_CONTEXT_STATE para solicitações de definição e consulta.
Nesta versão do modelo de driver, o driver de miniporta tenta ativação de contexto somente conforme instruído pelo Serviço MB. (Os drivers de miniport 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 miniporto não deverá tentar fornecer uma cadeia de caracteres padrão. Em vez disso, ele deve continuar com a ativação do contexto com uma cadeia de caracteres de acesso em branco.
Por outro lado, o driver de miniporto 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 há suporte para apenas um contexto ativado nesta versão, ativar ou desativar um contexto específico equivale a configurar ou derrubar a conexão de camada 2 MB.
Em solicitações definidas, o serviço MB fornece os parâmetros ConnectionId e ActivationCommand na estrutura de dados WWAN_CONTEXT_STATE. Ele instrui o driver de miniporto 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 de miniporte deverá retornar o código de erro WWAN_STATUS_SERVICE_NOT_ACTIVATED. A ativação PDP pode não acontecer até que o serviço ou a assinatura seja ativado. Todos os serviços de emergência podem estar disponíveis sujeitos ao suporte 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 miniporto 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 miniporto 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 de AccessString, UserName e Password de uma solicitação definida:
- Se ActivationCommand for WwanActivationCommandDeactivate, o driver de miniporto deverá ignorar as configurações desses três parâmetros. O restante dos casos só considera o caso quando ActivationCommand é WwanActivationCommandActivate.
A ativação de contexto persiste entre logon e 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 resposta a solicitações de consulta, o driver de miniporto envia a notificação de NDIS_STATUS_WWAN_CONTEXT_STATE.
Importante Nota:
Em circunstâncias raras, mas específicas, o Serviço MB no Windows 7 pode tentar se conectar 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 de 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 Gerenciador de Listas de Rede ainda está tentando determinar a conectividade com a Internet de outras conexões usando métodos ativos e passivos. Isso também pode ocorrer devido a interrupções temporárias na infraestrutura de rede, como um servidor proxy corporativo ou uma rede ISP. Portanto, o Serviço MB pode tentar se conectar automaticamente à Internet, independentemente de a opção "Conexão automática somente se nenhuma conexão de Internet alternativa estiver disponível" estiver selecionada.
Requisitos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |