NDIS_STATUS_WWAN_PIN_INFO
Los controladores de minipuerto usan la notificación de NDIS_STATUS_WWAN_PIN_INFO para responder a la consulta OID y establecer solicitudes de OID_WWAN_PIN.
Los controladores de miniport no pueden usar esta notificación para enviar eventos no solicitados.
Esta notificación usa la estructura NDIS_WWAN_PIN_INFO .
Observaciones
Los controladores de miniport deben devolver información sobre el número de identidad personal (PIN) que el dispositivo MB espera actualmente en respuesta a una solicitud de consulta. Los controladores de minipuerto deben devolver la notificación de estado rellenada como se describe en las secciones siguientes en respuesta a una solicitud establecida.
Responder a solicitudes WwanPinOperationEnter
Cuando los controladores de miniporte usan la notificación NDIS_STATUS_WWAN_PIN_INFO para responder a las solicitudes WwanPinOperationEnter , deben implementar estos procedimientos:
Para las solicitudes de consulta WwanPinOperationEnter correctas, cuando el dispositivo MB ya no requiere un PIN, los controladores de minipuerto deben establecer uStatus en WWAN_STATUS_SUCCESS y PinType en WwanPinTypeNone.
Para las solicitudes WwanPinOperationEnter erróneas, los controladores de miniport deben establecer uStatus en WWAN_STATUS_FAILURE e incluir los datos aplicables según los detalles siguientes:
PIN deshabilitado o pin no esperado: para las solicitudes de conjunto WwanPinOperationEnter , cuando el PIN correspondiente está deshabilitado o actualmente no esperado por el dispositivo MB, los controladores de minipuerto deben establecer PinType en WwanPinTypeNone. Todos los demás miembros se omiten.
PIN no compatible: si el dispositivo MB no admite el PIN especificado, los controladores de minipuerto deben establecer uStatus en WWAN_STATUS_NO_DEVICE_SUPPORT.
PIN Retrial: en este modo, el dispositivo MB requiere que se vuelva a escribir el PIN, ya que el valor AttemptsRemaining sigue siendo distinto de cero para este tipo determinado de PIN. Los controladores de minipuerto deben establecer PinType en el mismo valor que el de PinType en NDIS_WWAN_SET_PIN.
Bloqueo de PIN: el PIN se bloquea cuando AttemptsRemaining es cero. Si la operación de desbloqueo de PIN no está disponible, los controladores de miniport deben establecer uStatus en WWAN_STATUS_FAILURE y PinType en WwanPinTypeNone. Todos los demás miembros se omiten.
Nota Si el dispositivo MB admite operaciones de desbloqueo de PIN, los controladores de minipuerto deben seguir el paso de desbloqueo del PIN para responder a la solicitud.
Desbloqueo de PIN: el PIN se bloquea cuando AttemptsRemaining es cero. Para desbloquear el PIN, el dispositivo MB puede solicitar una clave de desbloqueo de PIN (PUK) correspondiente, si procede. En este caso, los controladores de minipuerto deben establecer PinType en el PUK WwanPinTypeXxxcorrespondiente con los detalles pertinentes.
PUK bloqueado: si el número de pruebas con errores supera el valor preestablecido para escribir el PUK WwanPinTypeXxx, el PUK se bloquea. Los controladores miniport deben indicarlo estableciendo uStatus en WWAN_STATUS_FAILURE y PinType en WwanPinTypeNone. En caso de que PUK1 esté bloqueado, los controladores de minipuerto deben enviar un NDIS_STATUS_WWAN_READY_INFO con ReadyState establecido en WwanReadyStateBadSim.
Responder a solicitudes wwanPinOperationEnable, WwanPinOperationDisable o WwanPinOperationChange
Cuando los controladores de miniporte usan la notificación NDIS_STATUS_WWAN_PIN_INFO para responder a WwanPinOperationEnable, WwanPinOperationDisable y WwanPinOperationChange, deben implementar las siguientes operaciones:
Para solicitudes correctas, los controladores de miniport deben establecer uStatus en WWAN_STATUS_SUCCESS. Para otros miembros de WWAN_PIN_INFO, consulte las siguientes circunstancias.
Los controladores de miniport deben establecer uStatus en WWAN_STATUS_SUCCESS para las operaciones de habilitación de PIN y deshabilitación de PIN cuando el PIN ya está en estado solicitado. Los controladores miniport deben establecer PinType en WwanPinTypeNone. Se omiten otros miembros.
Cuando se cambia un modo PIN de deshabilitado a habilitado, el estado del PIN debe ser WwanPinStateNone.
Si EL PIN1 está habilitado, el estado del PIN se convertirá en WwanPinStateEnter cuando la alimentación se recorra al dispositivo MB.
Para todos los demás PIN, el estado del PIN puede cambiar de WwanPinStateNone a WwanPinStateEnter en función de las condiciones específicas del dispositivo MB.
PIN no compatible: si el dispositivo MB no admite una operación de PIN, los controladores de minipuerto deben establecer uStatus en WWAN_STATUS_NO_DEVICE_SUPPORT. Por ejemplo, la habilitación y deshabilitación de PIN2 no suele ser compatible con dispositivos MB, por lo que se debe devolver el código de error anterior. Todos los demás miembros se omiten.
Pin debe especificarse: si una operación de PIN requiere que se escriba un PIN, los controladores de minipuerto deben establecer uStatus en WWAN_STATUS_PIN_REQUIRED y PinType en WwanPinTypeXxx. Se omiten otros miembros.
Operación de cambio de PIN: si el dispositivo MB restringe el cambio de valor de PIN solo cuando está en estado habilitado, se debe devolver una solicitud para cambiar en estado deshabilitado con WWAN_STATUS_PIN_DISABLED.
PIN Retrial: en caso de error, los controladores de minipuerto deben establecer uStatus en WWAN_STATUS_FAILURE y PinType en el mismo valor especificado en NDIS_WWAN_SET_PIN. Otros miembros se omiten excepto AttemptsRemaining. Esto puede ocurrir cuando se escribe un PIN incorrecto.
Bloqueo de PIN: el PIN se bloquea cuando el número de intentosRemaining es cero. Si la operación de desbloqueo de PIN no está disponible, los controladores de miniport deben establecer uStatus en WWAN_STATUS_FAILURE y PinType en WwanPinTypeNone. AttemptsRemaining debe establecerse en 0 y se omiten todos los demás miembros.
Nota Si el dispositivo MB admite operaciones de desbloqueo de PIN, los controladores de minipuerto deben seguir el paso de desbloqueo del PIN para responder a la solicitud.
Pin de desbloqueo: el PIN se bloquea cuando AttemptsRemaining es cero. Para desbloquear el PIN, el dispositivo MB puede solicitar una PUK correspondiente, si procede. En este caso, los controladores de miniport deben establecer uStatus en WWAN_STATUS_FAILURE, PinType en el PUK WwanPinTypeXxxcorrespondiente, PinState en WwanPinStateEnter e AttemptsRemaining deben tener el número de intentos permitidos para introducir una PUK válida.
Si el bloqueo de PIN da como resultado el bloqueo del dispositivo MB o sim, los controladores de miniport deben enviar una notificación de eventos con ReadyState establecido en WwanReadyStateDeviceLocked.
Si hay un contexto PDP activo en el momento del bloqueo de PIN1, los controladores de minipuerto deben desactivar el contexto PDP y enviar notificaciones al sistema operativo sobre el cambio de estado de vínculo y desactivación de PDP.
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ndis.h |