NDIS_STATUS_WWAN_PIN_INFO
Os drivers de miniport usam a notificação NDIS_STATUS_WWAN_PIN_INFO para responder à consulta OID e definir solicitações de OID_WWAN_PIN.
Os drivers de miniporto não podem usar essa notificação para enviar eventos não solicitados.
Essa notificação usa a estrutura NDIS_WWAN_PIN_INFO .
Comentários
Os drivers de miniporto 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 miniporte devem retornar o status notificação preenchida conforme descrito nas seções abaixo em resposta a uma solicitação definida.
Respondendo a solicitações WwanPinOperationEnter
Quando os drivers de miniporto usam a notificação NDIS_STATUS_WWAN_PIN_INFO para responder às solicitações WwanPinOperationEnter , eles devem implementar estes procedimentos:
Para solicitações de consulta WwanPinOperationEnter bem-sucedidas, quando o dispositivo MB não exige mais um PIN, os drivers de miniport devem definir uStatus como WWAN_STATUS_SUCCESS e PinType como WwanPinTypeNone.
Para solicitações WwanPinOperationEnter com falha, os drivers de miniport devem definir uStatus como WWAN_STATUS_FAILURE e incluir dados aplicáveis de acordo com os seguintes detalhes:
PIN Desabilitado ou PIN Não Esperado: para solicitações de conjunto WwanPinOperationEnter , quando o PIN correspondente está desabilitado ou atualmente não é esperado pelo dispositivo MB, os drivers de miniport devem definir PinType como WwanPinTypeNone. Todos os outros membros são ignorados.
PIN Sem Suporte: se o PIN fornecido não for compatível com o dispositivo MB, os drivers de miniporto deverão definir uStatus como WWAN_STATUS_NO_DEVICE_SUPPORT.
Novo julgamento de PIN: nesse modo, o dispositivo MB requer que o PIN seja inserido novamente, pois o valor AttemptsRemaining ainda não é zero para esse tipo específico de PIN. Os drivers de miniport devem definir PinType com o mesmo valor de PinType em 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 miniporto deverão definir uStatus como WWAN_STATUS_FAILURE e PinType como WwanPinTypeNone. Todos os outros membros são ignorados.
Nota Se o dispositivo MB der suporte a operações de desbloqueio de PIN, os drivers de miniport devem seguir a etapa Desbloqueando PIN para responder à solicitação.
Desbloqueio de PIN: o PIN é bloqueado quando AttemptsRemaining é zero. Para desbloquear o PIN, o dispositivo MB pode solicitar uma PUK (chave de desbloqueio de PIN) correspondente, se aplicável. Nesse caso, os drivers de miniporto devem definir PinType como o WwanPinTypeXxxPUK correspondente com os detalhes relevantes.
PUK bloqueado: se o número de avaliações com falha exceder o valor predefinido para inserir o WwanPinTypeXxxPUK, o PUK será bloqueado. Os drivers de miniport devem sinalizar isso definindo uStatus como WWAN_STATUS_FAILURE e PinType como WwanPinTypeNone. Caso o PUK1 seja bloqueado, os drivers de miniporto devem enviar uma NDIS_STATUS_WWAN_READY_INFO com ReadyState definido como WwanReadyStateBadSim.
Respondendo às solicitações WwanPinOperationEnable, WwanPinOperationDisable ou WwanPinOperationChange
Quando os drivers de miniport usam a notificação NDIS_STATUS_WWAN_PIN_INFO para responder a WwanPinOperationEnable, WwanPinOperationDisable e WwanPinOperationChange, eles devem implementar as seguintes operações:
Para solicitações bem-sucedidas, os drivers de miniport devem definir uStatus como WWAN_STATUS_SUCCESS. Para outros membros no WWAN_PIN_INFO, consulte as seguintes circunstâncias.
Os drivers de miniporto devem definir uStatus como WWAN_STATUS_SUCCESS para operações habilitadas por PIN e desabilitar PIN quando o PIN já estiver no estado solicitado. Os drivers de miniport devem definir PinType como WwanPinTypeNone. Outros membros são ignorados.
Quando um modo PIN é alterado de desabilitado para habilitado, o estado pin deve ser WwanPinStateNone.
Se PIN1 estiver habilitado, o estado do PIN se tornará WwanPinStateEnter quando a energia for circulada 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 Sem Suporte: se não houver suporte para uma operação de PIN pelo dispositivo MB, os drivers de miniporto deverão definir uStatus como WWAN_STATUS_NO_DEVICE_SUPPORT. Por exemplo, a habilitação e a desabilitação do PIN2 normalmente não são compatíveis com dispositivos MB, portanto, o código de erro acima deve ser retornado. Todos os outros membros são ignorados.
PIN deve ser inserido: se uma operação PIN exigir que um PIN seja inserido, os drivers de miniporto deverão definir uStatus como WWAN_STATUS_PIN_REQUIRED e PinType como WwanPinTypeXxx. Outros membros são ignorados.
Operação de alteração de PIN: se o dispositivo MB restringir a alteração do valor de PIN somente quando ele estiver no estado habilitado, uma solicitação para alterar o estado desabilitado deverá ser retornada com WWAN_STATUS_PIN_DISABLED.
Novo julgamento de PIN: em caso de falha, os drivers de miniporto 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 para AttemptsRemaining. Isso pode ocorrer quando um PIN incorreto é inserido.
Bloqueio de PIN: o PIN é bloqueado quando o número de TentativasRemaining é zero. Se a operação de desbloqueio de PIN não estiver disponível, os drivers de miniporto deverão definir uStatus como WWAN_STATUS_FAILURE e PinType como WwanPinTypeNone. AttemptsRemaining deve ser definido como 0 e todos os outros membros são ignorados.
Nota Se o dispositivo MB der suporte a operações de desbloqueio de PIN, os drivers de miniport devem seguir a etapa Desbloqueando PIN para responder à solicitação.
Desbloqueio de 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 miniporto devem definir uStatus como WWAN_STATUS_FAILURE, PinType para o WwanPinTypeXxxPUK correspondente, PinState para WwanPinStateEnter e AttemptsRemaining deve ter o número de tentativas permitidas para inserir um PUK válido.
Se os resultados do bloqueio de PIN no dispositivo MB ou sim forem bloqueados, os drivers de miniporto 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 miniport devem 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.
Requisitos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
parâmetro |
Ndis.h |