Partilhar via


OID_WWAN_READY_INFO

OID_WWAN_READY_INFO retorna o estado pronto do dispositivo, que inclui o módulo de identidade do assinante (cartão sim). Normalmente, isso ocorre no início de qualquer sessão.

Não há suporte para definir solicitações.

O host poderá 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 desse OID contém uma estrutura de 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 miniporto devem processar solicitações de consulta de forma assíncrona, retornando inicialmente NDIS_STATUS_INDICATION_REQUIRED para a solicitação original e, posteriormente, enviando um NDIS_STATUS_WWAN_READY_INFO status notificação 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 Preparação do dispositivo MB.

Os drivers de miniport podem acessar a memória do dispositivo ou a cartão sim ao processar operações de consulta, mas não devem acessar a rede do provedor.

Os drivers de miniporte 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 miniporta nunca devem falhar OID_WWAN_READY_INFO e sempre devem retornar o estado pronto do dispositivo correto.

Os drivers de miniporta 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 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 miniporta 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 carregar o driver de miniporto se nenhum cartão SIM estiver presente, como pode ser o caso com dispositivos que permitem que cartões SIM sejam inseridos ou removidos. Se o dispositivo tiver a capacidade de detectar uma inserção frequente 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 como 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 miniporto 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 de firmware correta esteja disponível. Se a revisão de firmware não estiver disponível, o driver de miniporto deverá concluir a transação de notificação de evento definindo ReadyInfo.ReadyState como WwanReadyStateFailure.

Requisitos

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

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

Confira também

NDIS_WWAN_READY_INFO

NDIS_STATUS_WWAN_READY_INFO

NDIS_WWAN_QUERY_READY_INFO

WWAN_QUERY_READY_INFO

Preparação do dispositivo MB