OID_WWAN_READY_INFO

  • Articolo

OID_WWAN_READY_INFO restituisce lo stato pronto per il dispositivo, che include il modulo identità sottoscrittore (scheda SIM). Questo si verifica in genere all'inizio di qualsiasi sessione.

Le richieste di set non sono supportate.

L'host può eseguire una query sullo stato pronto dallo slot SIM attivo o dallo slot SIM inattivo nel dispositivo se il dispositivo supporta slot dual SIM. Il payload dell'OID contiene una struttura NDIS_WWAN_QUERY_READY_INFO , che a sua volta contiene una struttura WWAN_QUERY_READY_INFO che specifica l'ID dello slot UICC.

I driver Miniport devono elaborare le richieste di query in modo asincrono, inizialmente restituendo NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale e successivamente inviando una notifica di stato NDIS_STATUS_WWAN_READY_INFO contenente una struttura NDIS_WWAN_READY_INFO che indica lo stato pronto del dispositivo MB durante il completamento delle richieste di query.

Commenti

Per altre informazioni sull'uso di questo OID, vedere Conformità del dispositivo MB.

I driver Miniport possono accedere alla memoria del dispositivo o alla scheda SIM durante l'elaborazione delle operazioni di query, ma non devono accedere alla rete del provider.

I driver Miniport devono attendere fino a quando il PIN non viene cancellato (se necessario) e quindi leggere l'identità e i numeri di telefono del sottoscrittore (TN) e quindi impostare il membro ReadyInfo.ReadyState della struttura NDIS_WWAN_READY_INFO su WwanReadyStateInitialized.

I driver miniport non devono mai avere esito negativo OID_WWAN_READY_INFO e devono sempre restituire lo stato corretto del dispositivo pronto.

I driver miniport devono sempre notificare al servizio MB ogni volta che cambia lo stato pronto per il dispositivo.

I driver miniport devono seguire questa procedura per offrire un'esperienza utente ottimale:

  • Se PIN1 è bloccato, i driver miniport devono prima inviare una notifica di evento ready-state con ReadyInfo.ReadyStateimpostata su WwanReadyStateDeviceLocked. Il servizio MB invia quindi il driver miniport a una richiesta del set OID di OID_WWAN_PIN. Dopo lo sblocco del dispositivo, il driver miniport deve inviare un'altra notifica di evento ready-state con ReadyInfo.ReadyState impostata su WwanReadyStateInitialized. Fino a quando PIN1 non viene sbloccato correttamente, i driver miniport non devono modificare lo stato pronto per il dispositivo in WwanReadyStateInitialized.

  • I driver Miniport devono prima inviare una notifica evento con ReadyInfo.ReadyState impostata su WwanReadyStateSimNotInserted quando il servizio MB carica il driver miniport se non è presente alcuna scheda SIM, come potrebbe essere il caso con i dispositivi che consentono l'inserimento o la rimozione delle schede SIM. Se il dispositivo ha la possibilità di rilevare un inserimento frequente di una scheda SIM, il driver miniport deve inviare un'altra notifica evento con ReadyInfo.ReadyState impostata su WwanReadyStateInitialized quando l'utente inserisce una SIM.

  • I dispositivi che dispongono della funzionalità per rilevare lo stato di attivazione del servizio devono impostare ReadyInfo.ReadyState su WwanReadyStateNotActivated. Inoltre, se il driver miniport supporta l'attivazione del servizio, il driver miniport riceverà una richiesta OID set di OID_WWAN_SERVICE_ACTIVATION. Al termine dell'attivazione del servizio, i driver miniport devono inviare un'altra notifica evento con ReadyInfo.ReadyState impostata su WwanReadyStateInitialized.

  • I driver Miniport che richiedono una revisione del firmware specifica devono assicurarsi che sia disponibile la revisione del firmware corretta. Se la revisione del firmware non è disponibile, il driver miniport deve completare la transazione di notifica dell'evento impostando ReadyInfo.ReadyState su WwanReadyStateFailure.

Requisiti

Versione: disponibile in Windows 7 e versioni successive di Windows.

Intestazione: Ntddndis.h (include Ndis.h)

Vedi anche

NDIS_WWAN_READY_INFO

NDIS_STATUS_WWAN_READY_INFO

NDIS_WWAN_QUERY_READY_INFO

WWAN_QUERY_READY_INFO

Conformità del dispositivo MB