OID_WWAN_READY_INFO
OID_WWAN_READY_INFO devuelve el estado listo del dispositivo, que incluye su módulo de identidad de suscriptor (tarjeta SIM). Esto suele ocurrir al principio de cualquier sesión.
No se admiten solicitudes de establecimiento.
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 miniport 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 de 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 MB device Readiness.
Los controladores de miniport 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 miniport 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 miniport nunca deben producir errores OID_WWAN_READY_INFO y siempre deben devolver el estado correcto listo para el dispositivo.
Los controladores de miniport siempre deben notificar al servicio MB siempre que cambie el estado listo del dispositivo.
Los controladores de miniport deben seguir estos pasos para proporcionar una buena experiencia de usuario:
Si PIN1 está bloqueado, los controladores de miniport deben enviar primero 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 miniportar una solicitud de conjunto de OID de OID_WWAN_PIN. Después de desbloquear el dispositivo, el controlador de miniport 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 miniportar no deben cambiar el estado listo del dispositivo para WwanReadyStateInitialized.
Los controladores de miniport deben enviar primero una notificación de eventos con ReadyInfo.ReadyState establecido en WwanReadyStateSimNotInserted cuando el servicio MB carga el controlador de miniport 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 miniport 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 miniporte admite la activación del servicio, el controlador de miniporte 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 miniporte 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 de firmware no está disponible, el controlador de miniport 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)
Consulte también
MB de de preparación de dispositivos