Partilhar via


NDIS_STATUS_WWAN_PIN_INFO

Os drivers de miniporta usam a notificação de NDIS_STATUS_WWAN_PIN_INFO para responder à consulta OID e definir solicitações de OID_WWAN_PIN.

Os drivers de miniporta não podem usar essa notificação para enviar eventos não solicitados.

Esta notificação utiliza a estrutura NDIS_WWAN_PIN_INFO.

Comentários

Os drivers de miniporta devem retornar informações sobre o PIN (Número de Identidade Pessoal) que o dispositivo MB espera atualmente em resposta a uma solicitação de consulta. Os drivers de miniporta devem retornar a notificação de status preenchida conforme descrito nas seções abaixo em resposta a uma solicitação definida.

Respondendo a solicitações WwanPinOperationEnter

Quando os drivers de miniporta usam a notificação de NDIS_STATUS_WWAN_PIN_INFO para responder a solicitações de WwanPinOperationEnter, eles devem implementar estes procedimentos:

  • Para bem-sucedidos WwanPinOperationEnter solicitações de consulta, quando o dispositivo MB não requer mais um PIN, os drivers de miniporta devem definir uStatus como WWAN_STATUS_SUCCESS e PinType para WwanPinTypeNone.

  • Para solicitações de WwanPinOperationEnter com falha, os drivers de miniporta devem definir uStatus como WWAN_STATUS_FAILURE e incluir dados aplicáveis de acordo com os seguintes detalhes:

    • PIN desativado ou PIN não esperado: para WwanPinOperationEnter solicitações definidas, quando o PIN correspondente estiver desativado ou atualmente não for esperado pelo dispositivo MB, os drivers de miniporta devem definir PinType como WwanPinTypeNone. Todos os outros membros são ignorados.

    • PIN não suportado: Se o PIN fornecido não for suportado pelo dispositivo MB, os drivers de miniporta devem definir uStatus como WWAN_STATUS_NO_DEVICE_SUPPORT.

    • PIN Retrial: Neste modo, o dispositivo MB requer que o PIN seja reintroduzido, uma vez que o valor AttemptsRemaining ainda é diferente de zero para este tipo específico de PIN. Os drivers de miniporta devem definir PinType com o mesmo valor de PinType no NDIS_WWAN_SET_PIN.

    • Bloqueio de PIN: O PIN é bloqueado quando AttemptsRemaining é zero. Se a operação de desbloqueio de PIN não estiver disponível, os drivers de miniporta deverão definir uStatus como WWAN_STATUS_FAILURE e PinType para WwanPinTypeNone. Todos os outros membros são ignorados.

      Nota Se o dispositivo MB suportar operações de desbloqueio de PIN, os controladores de miniporta devem seguir o passo de Desbloqueio de PIN para responder ao pedido.

    • Desbloqueio de PIN: O PIN é bloqueado quando TentativasRestantes é zero. Para desbloquear o PIN, o dispositivo MB pode solicitar uma chave de desbloqueio PIN (PUK) correspondente, se aplicável. Nesse caso, os drivers de miniporta devem definir PinType para o correspondente WwanPinTypeXxxPUK com os detalhes relevantes.

    • PUK bloqueado: Se o número de tentativas com falha exceder o valor predefinido para inserir o WwanPinTypeXxxPUK, o PUK será bloqueado. Os drivers de miniporta devem sinalizar isso definindo uStatus como WWAN_STATUS_FAILURE e PinType como WwanPinTypeNone. Caso o PUK1 esteja bloqueado, os drivers de miniporta devem enviar um NDIS_STATUS_WWAN_READY_INFO com ReadyState definido como WwanReadyStateBadSim.

Respondendo a solicitações WwanPinOperationEnable, WwanPinOperationDisable ou WwanPinOperationChange

Quando os drivers de miniporta usam a notificação de NDIS_STATUS_WWAN_PIN_INFO para responder a WwanPinOperationEnable, WwanPinOperationDisablee WwanPinOperationChange, eles devem implementar as seguintes operações:

  • Para solicitações bem-sucedidas, os drivers de miniporta devem definir uStatus como WWAN_STATUS_SUCCESS. Para outros membros em WWAN_PIN_INFO, consulte as seguintes circunstâncias.

  • Os drivers de miniporta devem definir uStatus para WWAN_STATUS_SUCCESS para operações de habilitação e desativação de PIN quando o PIN já estiver no estado solicitado. Os drivers de miniporta devem definir PinType como WwanPinTypeNone. Outros membros são ignorados.

  • Quando um modo PIN é alterado de desativado para ativado, o estado do PIN deve ser WwanPinStateNone.

  • Se o PIN1 estiver ativado, o estado do PIN deve tornar-se WwanPinStateEnter quando a alimentação for transferida para o dispositivo MB.

  • Para todos os outros PINs, o estado do PIN pode mudar de WwanPinStateNone para WwanPinStateEnter dependendo das condições específicas do dispositivo MB.

  • PIN não suportado: Se uma operação de PIN não for suportada pelo dispositivo MB, os drivers de miniporta deverão definir uStatus como WWAN_STATUS_NO_DEVICE_SUPPORT. Por exemplo, ativar e desativar o PIN2 não é normalmente suportado por dispositivos MB, pelo que o código de erro acima tem de ser devolvido. Todos os outros membros são ignorados.

  • PIN deve ser inserido: Se uma operação de PIN exigir que um PIN seja inserido, os drivers de miniporta devem definir uStatus como WWAN_STATUS_PIN_REQUIRED e PinType para WwanPinTypeXxx. Outros membros são ignorados.

  • Operação de alteração do PIN: Se o dispositivo MB restringir a alteração do valor do PIN apenas quando estiver no estado ativado, uma solicitação de alteração no estado desativado deverá ser retornada com WWAN_STATUS_PIN_DISABLED.

  • PIN Retrial: Em caso de falha, os drivers de miniporta devem definir uStatus como WWAN_STATUS_FAILURE e PinType com o mesmo valor especificado em NDIS_WWAN_SET_PIN. Outros membros são ignorados, exceto AttemptsRemaining. Isso pode ocorrer quando um PIN incorreto é inserido.

  • Bloqueio de PIN: O PIN é bloqueado quando o número de TentativasRestantes é zero. Se a operação de desbloqueio de PIN não estiver disponível, os drivers de miniporta deverão definir uStatus como WWAN_STATUS_FAILURE e PinType para WwanPinTypeNone. TentativasAs restantes devem ser definidas como 0 e todos os outros membros são ignorados.

    Nota Se o dispositivo MB suportar operações de desbloqueio de PIN, os controladores de miniporta devem seguir o passo de Desbloqueio de PIN para responder ao pedido.

  • Desbloqueando PIN: O PIN é bloqueado quando AttemptsRemaining é zero. Para desbloquear o PIN, o dispositivo MB pode solicitar um PUK correspondente, se aplicável. Nesse caso, os drivers de miniporta devem definir uStatus como WWAN_STATUS_FAILURE, PinType para o correspondente WwanPinTypeXxxPUK, PinState para WwanPinStateEntere AttemptsRemaining deve ter o número de tentativas permitido para inserir um PUK válido.

    Se o bloqueio de PIN resultar no bloqueio do dispositivo MB ou do SIM, os drivers de miniporta deverão enviar uma notificação de evento com ReadyState definido como WwanReadyStateDeviceLocked.

  • Se houver um contexto PDP ativo no momento do bloqueio do PIN1, os drivers de miniporta deverão desativar o contexto PDP e enviar notificações ao sistema operacional sobre a desativação do PDP e a alteração do estado do link.

Requerimentos

Versão

Disponível no Windows 7 e versões posteriores do Windows.

Cabeçalho

Ndis.h

Ver também

OID_WWAN_PIN

NDIS_STATUS_WWAN_PIN_INFO