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 |