OID_WWAN_READY_INFO
OID_WWAN_READY_INFO devuelve el estado listo para el dispositivo, que incluye su módulo de identidad de suscriptor (tarjeta SIM). Esto suele ocurrir al principio de cualquier sesión.
No se admiten las solicitudes establecidas.
El host puede consultar el estado listo desde la ranura SIM activa o la ranura SIM inactiva en el dispositivo si el dispositivo admite ranuras sim duales. La carga de este OID contiene una estructura de NDIS_WWAN_QUERY_READY_INFO , que a su vez contiene una estructura de WWAN_QUERY_READY_INFO que especifica el identificador de ranura UICC.
Los controladores de minipuerto deben procesar las solicitudes de consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original y, posteriormente, enviando una notificación de estado de NDIS_STATUS_WWAN_READY_INFO que contiene una estructura NDIS_WWAN_READY_INFO que indica el estado listo del dispositivo MB al completar las solicitudes de consulta.
Observaciones
Para obtener más información sobre el uso de este OID, consulte Preparación para dispositivos MB.
Los controladores de minipuerto pueden acceder a la memoria del dispositivo o a la tarjeta SIM al procesar las operaciones de consulta, pero no deben acceder a la red del proveedor.
Los controladores de minipuerto deben esperar hasta que se borre el PIN (si es necesario) y luego lea la identidad y los números de teléfono (TN) del suscriptor y, a continuación, establezca el miembro ReadyInfo.ReadyState de la estructura de NDIS_WWAN_READY_INFO en WwanReadyStateInitialized.
Los controladores de minipuerto nunca deben fallar OID_WWAN_READY_INFO y siempre deben devolver el estado correcto listo para el dispositivo.
Los controladores de minipuerto siempre deben notificar al servicio MB siempre que cambie el estado listo para el dispositivo.
Los controladores de minipuerto deben seguir estos pasos para proporcionar una buena experiencia de usuario:
Si PIN1 está bloqueado, los controladores de minipuerto primero deben enviar una notificación de eventos de estado listo con ReadyInfo.ReadyState establecido en WwanReadyStateDeviceLocked. A continuación, el servicio MB envía al controlador de miniporte una solicitud de conjunto de OID de OID_WWAN_PIN. Después de que el dispositivo se desbloquee, el controlador de minipuerto debe enviar otra notificación de eventos de estado listo con ReadyInfo.ReadyState establecido en WwanReadyStateInitialized. Hasta que PIN1 se desbloquee correctamente, los controladores de minipuerto no deben cambiar el estado listo del dispositivo a WwanReadyStateInitialized.
Los controladores de minipuerto deben enviar primero una notificación de eventos con ReadyInfo.ReadyState establecido en WwanReadyStateSimNotInserted cuando el servicio MB carga el controlador de miniporte si no hay ninguna tarjeta SIM presente, como puede ser el caso de los dispositivos que permiten insertar o quitar tarjetas SIM. Si el dispositivo tiene la capacidad de detectar una inserción activa de una tarjeta SIM, el controlador de minipuerto debe enviar otra notificación de eventos con ReadyInfo.ReadyState establecido en WwanReadyStateInitialized cuando el usuario inserta una SIM.
Los dispositivos que tienen la capacidad de detectar el estado de activación del servicio deben establecer ReadyInfo.ReadyState en WwanReadyStateNotActivated. Además, si el controlador de minipuerto admite la activación del servicio, el controlador de minipuerto recibirá una solicitud de conjunto de OID de OID_WWAN_SERVICE_ACTIVATION. Al finalizar correctamente la activación del servicio, los controladores de miniport deben enviar otra notificación de eventos con ReadyInfo.ReadyState establecido en WwanReadyStateInitialized.
Los controladores de minipuerto que requieren una revisión de firmware específica deben asegurarse de que la revisión de firmware correcta esté disponible. Si la revisión del firmware no está disponible, el controlador de minipuerto debe completar la transacción de notificación de eventos estableciendo ReadyInfo.ReadyState en WwanReadyStateFailure.
Requisitos
Versión: disponible en Windows 7 y versiones posteriores de Windows.
Encabezado: Ntddndis.h (include Ndis.h)