Preparação do dispositivo MB

Este tópico descreve os procedimentos para garantir que um dispositivo MB esteja acessível e pronto para ser usado para atividades relacionadas à rede antes que o Serviço MB prossiga com a configuração de conexões de dados. O dispositivo está pronto a utilizar quando a subscrição do utilizador tiver sido ativada e as informações relacionadas com o subscritor forem armazenadas no dispositivo ou no Módulo de Identidade do Subscritor (cartão SIM)

O Serviço MB assume que um controlador de miniporta inicializa automaticamente o hardware do seu dispositivo MB (pilha de rádio, cartão SIM ou circuito equivalente) depois de o sistema o ter carregado, sem esperar por qualquer instrução do serviço.

Os drivers Miniport definem o estado pronto inicial do seu dispositivo MB como WwanReadyStateOff. À medida que prosseguem com a inicialização, os drivers de miniporta devem enviar notificações de eventos para informar o Serviço MB sobre alterações no estado pronto do dispositivo.

Os drivers Miniport devem parar o processo de inicialização se encontrarem quaisquer condições de erro. Depois que a condição de erro for resolvida, os drivers de miniporta podem retomar o processo de inicialização até que o dispositivo atinja o estado pronto WwanReadyStateInitialized.

Seguem-se exemplos de alguns cenários de erro:

• Se o dispositivo exigir um cartão SIM e o driver da miniporta detetar que nenhum cartão SIM está presente, o driver da miniporta deve enviar uma notificação de evento de estado pronto WwanReadyStateSimNotInserted, e o driver da miniporta deve permanecer nesse estado até que o utilizador insira um cartão SIM no dispositivo.

• Se o dispositivo requer um cartão SIM e o controlador da miniporta não consegue ler o cartão SIM que foi inserido (por exemplo, um U-RIM é inserido num dispositivo baseado em GSM ou um USIM é inserido num dispositivo baseado em CDMA) ou o cartão SIM não é compatível com o dispositivo (por exemplo, um USIM 3G é inserido num dispositivo 2G, que não pode interpretar o formato USIM), o driver de miniporta deve enviar uma notificação de evento de estado pronto WwanReadyStateBadSim , e o driver de miniporta deve permanecer nesse estado até que o usuário insira um cartão SIM correto no dispositivo.

• Se o dispositivo estiver bloqueado pelo PIN (para dispositivos que usam cartões SIM) ou por uma senha (para dispositivos que não usam cartões SIM) que impeça o progresso da inicialização do dispositivo, o driver de miniporta deve enviar uma notificação de evento de estado pronto WwanReadyStateDeviceLocked e o driver de miniporta deve permanecer nesse estado até que o usuário insira o PIN ou senha corretos.

• Se o driver de miniporta detetar que a ativação do serviço é necessária para continuar, o driver de miniporta deverá enviar uma notificação de evento de estado pronto WwanReadyStateNotActivated e deverá permanecer nesse estado até que o serviço tenha sido ativado. Este é um comportamento típico para dispositivos baseados em CDMA na América do Norte.

• Se o driver de miniporta tiver falhas diferentes das mencionadas anteriormente, o driver de miniporta deverá enviar uma notificação de evento de estado pronto WwanReadyStateFailure e deverá permanecer nesse estado até que o problema seja identificado e corrigido.

Esteja ciente de que o Serviço MB não assume que os drivers de miniporta podem detetar todos esses erros. O serviço não assume a ordem em que os drivers de miniportas detetam essas condições de erro. No entanto, é melhor implementar os cenários de erro na ordem listada anteriormente.

Até que um driver de miniporta envie uma notificação de evento de estado pronto WwanReadyStateInitialized , o serviço não prosseguirá com as atividades relacionadas à rede até que o problema tenha sido identificado e corrigido. No entanto, o serviço ainda pode enviar OIDs para o driver de microporta.

Os drivers de miniport não precisam aguardar que o subsistema SMS esteja pronto antes de reportar o estado de prontidão WwanReadyStateInitialized. Em vez disso, os drivers de miniporta devem enviar uma notificação OID_WWAN_SMS_CONFIGURATION separada quando o subsistema SMS estiver pronto para enviar e receber mensagens SMS.

Suporte ao Modo de Emergência

Se o driver da miniporta indicar que ele suporta serviços de chamada de emergência durante o processamento OID_WWAN_READY_INFO o driver da miniporta deve definir o membro EmergencyMode da estrutura WWAN_READY_INFO como WwanEmergencyModeOn. Neste caso, o controlador de miniporta deve continuar a enviar notificações de registo para o Serviço MB, mas o serviço não invocará quaisquer funcionalidades relacionadas com a configuração automática.

Os controladores de miniportas podem especificar que suportam serviços de chamada de emergência mesmo em cenários em que detetam que o SIM já não é válido, talvez porque a assinatura não foi paga ou o serviço foi desativado porque o dispositivo foi denunciado como roubado.

Inicialização do driver de miniporta MB

O diagrama a seguir representa o processo tomado para determinar se a interface é uma interface MB qualificada e para coletar informações sobre os recursos do dispositivo. Essas etapas são executadas para cada interface MB enumerada quando o Serviço MB é iniciado, bem como para cada chegada de nova interface enquanto o serviço está em execução. Os rótulos em negrito representam identificadores OID ou controle de fluxo transacional. Os rótulos em texto regular representam os sinalizadores importantes dentro da estrutura OID.

Para inicializar um driver de miniporta MB, use o seguinte procedimento:

1. O Serviço MB envia uma solicitação de consulta síncrona (bloqueante) OID_GEN_PHYSICAL_MEDIUM para identificar o tipo de dispositivo MB. O driver de miniporta responde com NdisPhysicalMediumWirelessWan para indicar que o dispositivo MB é um dispositivo WWAN.

2. O Serviço MB envia uma solicitação de consulta OID_GEN_MEDIA_SUPPORTED síncrona (bloqueio) para o driver de miniporta para identificar que tipo de meio o dispositivo MB usa. O driver de miniporta responde com NdisMedium802_3 para indicar que ele usa emulação Ethernet.

3. O Serviço MB envia uma solicitação de consulta síncrona (bloqueante) para OID_WWAN_DRIVER_CAPS ao driver de miniporta, a fim de identificar a versão do modelo de driver que ele suporta. O driver de miniport responde com WWAN_VERSION.

4. O Serviço MB envia uma solicitação de consulta OID_WWAN_DEVICE_CAPS assíncrona (sem bloqueio) para o driver de miniporta para identificar os recursos do dispositivo MB. O motorista da miniporta responde com uma confirmação provisória de que recebeu a solicitação e enviará uma notificação com as informações solicitadas no futuro.

5. O controlador miniporta envia uma notificação NDIS_STATUS_WWAN_DEVICE_CAPS para o Serviço MB que indica as capacidades do dispositivo MB que o controlador miniporta suporta. Por exemplo, se o driver de miniporta suporta um dispositivo baseado em GSM, ele deve especificar o valor WwanCellularClassGsm no membro DeviceCaps.WwanCellularClass da estrutura NDIS_WWAN_DEVICE_CAPS . Se o driver de miniporta suportar um dispositivo baseado em CDMA, ele deve especificar WwanCellularClassCdma.

** Inicialização do dispositivo GPRS SIM-Locked com um contexto User-Defined

O diagrama a seguir ilustra o cenário no qual o usuário insere um PIN do SIM e configura manualmente uma cadeia de caracteres de nome de ponto de acesso. Os rótulos em negrito são identificadores OID ou controle de fluxo transacional, e os rótulos em texto regular são os sinalizadores importantes dentro da estrutura OID.

Para inicializar um dispositivo baseado em GSM com PIN1 bloqueado, implemente as seguintes etapas:

1. O Serviço MB envia uma solicitação de consulta OID_WWAN_READY_INFO assíncrona (sem bloqueio) para o driver de miniporta para identificar o estado pronto do dispositivo. O motorista da miniporta responde com um aviso provisório (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

2. O driver da miniporta envia uma notificação de NDIS_STATUS_WWAN_FAILURE ao Serviço MB para indicar ao Serviço MB que o SIM (módulo de identidade do assinante) está bloqueado.

3. O Serviço MB envia uma solicitação de consulta OID_WWAN_PIN assíncrona (sem bloqueio) para o driver de miniporta. O motorista da miniporta responde com um aviso provisório (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

4. O driver de miniporta envia uma notificação de NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

5. O Serviço MB envia uma solicitação assíncrona (sem bloqueio) de definição de OID_WWAN_PIN para o controlador de miniporta. O motorista da miniporta responde com um aviso provisório (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

6. O driver de miniporta envia uma notificação de NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

7. O driver de miniporta envia uma notificação de NDIS_STATUS_WWAN_READY_INFO para o Serviço MB, indicando que o estado do dispositivo MB é WwanReadyStateInitialized.

8. O Serviço MB envia uma consulta OID_WWAN_REGISTER_STATE assíncrona (não bloqueante) para o driver de miniporta. O driver da miniporta responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e enviará uma notificação com as informações solicitadas posteriormente.

9. O driver de miniporta envia uma notificação de NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

10. O driver da miniporta envia uma notificação de NDIS_STATUS_WWAN_REGISTER_STATE para o Serviço MB.

11. O serviço MB envia uma solicitação de consulta assíncrona (sem bloqueio) de OID_WWAN_HOME_PROVIDER para o controlador de miniporta. O driver da miniporta responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e enviará uma notificação com as informações solicitadas posteriormente.

12. O driver de miniporta envia uma notificação de NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

13. O driver miniport envia uma notificação NDIS_STATUS_WWAN_REGISTER_STATE para o serviço MB.

14. O serviço MB envia uma solicitação assíncrona (sem bloqueio) de OID_WWAN_PACKET_SERVICE para o driver Miniport. O motorista da miniporta responde com um aviso provisório (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

15. O driver da miniporta envia uma notificação NDIS_STATUS_WWAN_PACKET_SERVICE para o Serviço MB.

16. O Serviço MB envia uma solicitação de consulta OID_WWAN_PROVISIONED_CONTEXTS assíncrona (sem bloqueio) para o driver de miniporta. O driver da miniporta responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e enviará uma notificação com as informações solicitadas posteriormente.

17. O driver de miniporta envia NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS para o serviço MB.

18. O Serviço MB envia uma solicitação assíncrona (sem bloqueio) OID_WWAN_PROVISIONED_CONTEXTS set para o Serviço MB. O driver da miniporta responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e enviará uma notificação com as informações solicitadas posteriormente.

19. O driver de miniport envia NDIS_STATUS_WWAN_SUCCESS ao serviço MB.

Ver também

Para obter mais informações sobre a prontidão do dispositivo, consulte OID_WWAN_READY_INFO.

Para obter mais informações sobre a inicialização de dispositivos com contextos provisionados, consulte MB Provisioned Context Operations.