NDIS_STATUS_WWAN_PIN_INFO
Los controladores de miniportar 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 miniport 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 de NDIS_STATUS_WWAN_PIN_INFO para responder a las solicitudes de WwanPinOperationEnter, deben implementar estos procedimientos:
Para solicitudes de consulta wwanPinOperationEnter correctas, cuando el dispositivo MB ya no requiere un PIN, los controladores de miniport deben establecer uStatus en WWAN_STATUS_SUCCESS y PinType para WwanPinTypeNone.
Para las solicitudes de WwanPinOperationEnter, los controladores de miniport deben establecer uStatus en WWAN_STATUS_FAILURE e incluir datos aplicables según los detalles siguientes:
PIN deshabilitado o no esperado: para WwanPinOperationEnter solicitudes establecidas, cuando el PIN correspondiente está deshabilitado o actualmente no esperado por el dispositivo MB, los controladores de miniport deben establecer PinType en WwanPinTypeNone. Se omiten todos los demás miembros.
PIN no compatible: si el dispositivo MB no admite el PIN especificado, los controladores de miniport deben establecer uStatus en WWAN_STATUS_NO_DEVICE_SUPPORT.
Pin Retrial: en este modo, el dispositivo MB requiere que se vuelva a introducir el PIN como el AttemptsRemaining valor sigue siendo distinto de cero para este tipo determinado de PIN. Los controladores de miniport 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. Se omiten todos los demás miembros.
Nota Si el dispositivo MB admite operaciones de desbloqueo de PIN, los controladores de miniporte 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 miniport deben establecer PinType en elXxxPUK correspondiente de WwanPinType con los detalles pertinentes.
PUK bloqueado: si el número de pruebas con errores supera el valor preestablecido para escribir wwanPinTypeXxxPUK, la PUK se bloquea. Los controladores de miniport deben indicarlo estableciendo uStatus en WWAN_STATUS_FAILURE y PinType en WwanPinTypeNone. En caso de que PUK1 esté bloqueado, los controladores de miniport 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 de NDIS_STATUS_WWAN_PIN_INFO para responder a WwanPinOperationEnable, WwanPinOperationDisabley WwanPinOperationChange, deben implementar las siguientes operaciones:
Para las 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 y deshabilitación de PIN cuando el PIN ya está en estado solicitado. Los controladores de 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 PIN1 está habilitado, el estado del PIN se convertirá en WwanPinStateEnter cuando la alimentación se descienda 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 miniport 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. Se omiten todos los demás miembros.
Pin debe especificarse: si una operación de PIN requiere que se escriba un PIN, los controladores de miniport 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 miniportar deben establecer uStatus en WWAN_STATUS_FAILURE y PinType en el mismo valor especificado en NDIS_WWAN_SET_PIN. Otros miembros se omiten, excepto para AttemptsRemaining. Esto puede ocurrir cuando se escribe un PIN incorrecto.
Bloqueo de PIN: el PIN se bloquea cuando el número de 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. 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 miniporte 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 elXxxPUK correspondiente, PinState para WwanPinStateEntery AttemptsRemaining debe tener el número de intentos permitidos para entrar en 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 miniportar deben desactivar el contexto PDP y enviar notificaciones al sistema operativo sobre el cambio de estado de desactivación y vínculo de PDP.
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ndis.h |