OID_WWAN_READY_INFO
OID_WWAN_READY_INFO retorna o estado pronto do dispositivo, que inclui seu módulo de identidade do assinante (cartão SIM). Isso normalmente ocorre no início de qualquer sessão.
Não há suporte para solicitações de conjunto.
O anfitrião pode consultar o estado pronto a partir da ranhura SIM ativa ou da ranhura SIM inativa no dispositivo se o dispositivo suportar ranhuras SIM duplas. A carga útil deste OID contém uma estrutura NDIS_WWAN_QUERY_READY_INFO, que por sua vez contém uma estrutura WWAN_QUERY_READY_INFO que especifica o ID do slot UICC.
Os drivers de miniporta devem processar solicitações de 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_READY_INFO contendo uma estrutura NDIS_WWAN_READY_INFO que indica o estado pronto do dispositivo MB ao concluir solicitações de consulta.
Comentários
Para obter mais informações sobre como usar esse OID, consulte MB device Readiness.
Os drivers de miniporta podem acessar a memória do dispositivo ou o cartão SIM ao processar operações de consulta, mas não devem acessar a rede do provedor.
Os drivers de miniporta devem aguardar até que o PIN seja limpo (se necessário) e, em seguida, ler a identidade e o(s) número(s) de telefone (TNs) do assinante e, em seguida, definir o membro ReadyInfo.ReadyState da estrutura NDIS_WWAN_READY_INFO como WwanReadyStateInitialized.
Os drivers de miniporta nunca devem falhar OID_WWAN_READY_INFO e devem sempre retornar o estado pronto correto do dispositivo.
Os drivers de miniporta devem sempre notificar o Serviço MB sempre que o estado pronto do dispositivo for alterado.
Os drivers de miniporta devem seguir estas etapas para fornecer uma boa experiência ao usuário:
Se o PIN1 estiver bloqueado, os drivers de miniporta devem primeiro enviar uma notificação de evento de estado pronto com ReadyInfo.ReadyState definido como WwanReadyStateDeviceLocked. Em seguida, o serviço MB envia ao driver de miniporta uma solicitação de conjunto OID de OID_WWAN_PIN. Depois que o dispositivo for desbloqueado, o driver da miniporta deverá enviar outra notificação de evento de estado pronto com ReadyInfo.ReadyState definido como WwanReadyStateInitialized. Até que o PIN1 seja desbloqueado com êxito, os drivers de miniporta não devem alterar o estado pronto do dispositivo para WwanReadyStateInitialized.
Os drivers de miniporta devem primeiro enviar uma notificação de evento com ReadyInfo.ReadyState definido como WwanReadyStateSimNotInserted quando o Serviço MB carrega o driver da miniporta se nenhum cartão SIM estiver presente, como pode ser o caso de dispositivos que permitem que cartões SIM sejam inseridos ou removidos. Se o dispositivo tiver a capacidade de detetar uma inserção a quente de um cartão SIM, o driver de miniporta deve enviar outra notificação de evento com ReadyInfo.ReadyState definido como WwanReadyStateInitialized quando o usuário insere um SIM.
Os dispositivos que têm a capacidade de detetar o estado de ativação do serviço devem definir ReadyInfo.ReadyState como WwanReadyStateNotActivated. Além disso, se o driver de miniporta suportar a ativação de serviço, o driver de miniporta receberá uma solicitação de conjunto OID de OID_WWAN_SERVICE_ACTIVATION. Após a conclusão bem-sucedida da ativação do serviço, os drivers de miniporta devem enviar outra notificação de evento com ReadyInfo.ReadyState definido como WwanReadyStateInitialized.
Os drivers de miniporta que exigem uma revisão de firmware específica devem garantir que a revisão de firmware correta esteja disponível. Se a revisão de firmware não estiver disponível, o driver de miniporta deverá concluir a transação de notificação de evento definindo ReadyInfo.ReadyState como WwanReadyStateFailure.
Requerimentos
Versão: Disponível no Windows 7 e versões posteriores do Windows.
do cabeçalho : Ntddndis.h (incluir Ndis.h)
Ver também
MB de de preparação do dispositivo