Compartilhar via


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 definir solicitações.

O host pode consultar o estado pronto do slot sim ativo ou do slot sim inativo no dispositivo se o dispositivo der suporte a slots SIM duplos. O conteúdo dessa OID contém uma estrutura NDIS_WWAN_QUERY_READY_INFO, que, por sua vez, contém uma estrutura WWAN_QUERY_READY_INFO que especifica a ID do slot UICC.

Os drivers de miniport 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 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.

Observações

Para obter mais informações sobre como usar essa OID, consulte mb device Readiness.

Os drivers de miniport 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 miniport devem aguardar até que o PIN seja limpo (se necessário) e, em seguida, ler a identidade do assinante e os números de telefone (TNs) e, em seguida, definir o membro ReadyInfo.ReadyState da estrutura NDIS_WWAN_READY_INFO como WwanReadyStateInitialized.

Os drivers de miniporto nunca devem falhar OID_WWAN_READY_INFO e sempre devem retornar o estado pronto do dispositivo correto.

Os drivers de miniporto sempre devem notificar o Serviço MB sempre que o estado pronto do dispositivo for alterado.

Os drivers de miniport devem seguir estas etapas para fornecer uma boa experiência do usuário:

  • Se o PIN1 estiver bloqueado, os drivers de miniporto deverão 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 miniporto uma solicitação de conjunto de OID de OID_WWAN_PIN. Depois que o dispositivo é desbloqueado, o driver de miniporto deve 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 miniporto não devem alterar o estado pronto do dispositivo para WwanReadyStateInitialized.

  • Os drivers de miniport devem primeiro enviar uma notificação de evento com ReadyInfo.ReadyState definido como WwanReadyStateSimNotInserted quando o Serviço MB carrega o driver de miniporte 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 detectar uma inserção ativa de um cartão SIM, o driver de miniporto deverá enviar outra notificação de evento com ReadyInfo.ReadyState definido como WwanReadyStateInitialized quando o usuário inserir um SIM.

  • Os dispositivos que têm a capacidade de detectar o estado de ativação do serviço devem definir ReadyInfo.ReadyState para WwanReadyStateNotActivated. Além disso, se o driver de miniporto der suporte à ativação do serviço, o driver de miniporto receberá uma solicitação de conjunto de OID de OID_WWAN_SERVICE_ACTIVATION. Após a conclusão bem-sucedida da ativação do serviço, os drivers de miniport devem enviar outra notificação de evento com ReadyInfo.ReadyState definido como WwanReadyStateInitialized.

  • Os drivers de miniport que exigem uma revisão de firmware específica devem garantir que a revisão correta do firmware esteja disponível. Se a revisão do firmware não estiver disponível, o driver de miniporto deverá concluir a transação de notificação de evento definindo ReadyInfo.ReadyState para WwanReadyStateFailure.

Requisitos

versão: disponível no Windows 7 e versões posteriores do Windows.

cabeçalho: Ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_WWAN_READY_INFO

NDIS_STATUS_WWAN_READY_INFO

NDIS_WWAN_QUERY_READY_INFO

WWAN_QUERY_READY_INFO

mb device Readiness