NDIS_STATUS_WWAN_PIN_INFO
I driver Miniport usano la notifica NDIS_STATUS_WWAN_PIN_INFO per rispondere alla query OID e impostare le richieste di OID_WWAN_PIN.
I driver Miniport non possono usare questa notifica per inviare eventi non richiesti.
Questa notifica usa la struttura NDIS_WWAN_PIN_INFO .
Commenti
I driver Miniport devono restituire informazioni sul PIN (Personal Identity Number) previsto dal dispositivo MB in risposta a una richiesta di query. I driver Miniport devono restituire la notifica di stato compilata come descritto nelle sezioni seguenti in risposta a una richiesta impostata.
Risposta alle richieste WwanPinOperationEnter
Quando i driver miniport usano la notifica di NDIS_STATUS_WWAN_PIN_INFO per rispondere alle richieste WwanPinOperationEnter , devono implementare queste procedure:
Per le richieste di query WwanPinOperationEnter riuscite , quando il dispositivo MB non richiede più un PIN, i driver miniport devono impostare uStatus su WWAN_STATUS_SUCCESS e PinType su WwanPinTypeNone.
Per le richieste WwanPinOperationEnter non riuscite , i driver miniport devono impostare uStatus su WWAN_STATUS_FAILURE e includere i dati applicabili in base ai dettagli seguenti:
PIN Disabilitato o PIN non previsto: per le richieste set WwanPinOperationEnter , quando il PIN corrispondente è disabilitato o attualmente non previsto dal dispositivo MB, i driver miniport devono impostare PinType su WwanPinTypeNone. Tutti gli altri membri vengono ignorati.
PIN non supportato: se il PIN specificato non è supportato dal dispositivo MB, i driver miniport devono impostare uStatus su WWAN_STATUS_NO_DEVICE_SUPPORT.
PIN Retrial: in questa modalità, il dispositivo MB richiede che il PIN venga nuovamente immesso perché il valore AttemptsRemaining è ancora diverso da zero per questo particolare tipo di PIN. I driver Miniport devono impostare PinType sullo stesso valore di PinType in NDIS_WWAN_SET_PIN.
Blocco PIN: il PIN viene bloccato quando AttemptsRemaining è zero. Se l'operazione di sblocco del PIN non è disponibile, i driver miniport devono impostare uStatus su WWAN_STATUS_FAILURE e PinType su WwanPinTypeNone. Tutti gli altri membri vengono ignorati.
Nota Se il dispositivo MB supporta operazioni di sblocco del PIN, i driver miniport devono seguire il passaggio di sblocco del PIN per rispondere alla richiesta.
Sblocco PIN: il PIN viene bloccato quando AttemptsRemaining è zero. Per sbloccare il PIN, il dispositivo MB può richiedere una chiave di sblocco DEL PIN (PUK) corrispondente, se applicabile. In questo caso, i driver miniport devono impostare PinType sul PUK WwanPinTypeXxxcorrispondente con i dettagli pertinenti.
PuK bloccato: se il numero di versioni di valutazione non riuscite supera il valore predefinito per l'immissione del PUK WwanPinTypeXxx, la chiave puk viene bloccata. I driver Miniport devono segnalare questo valore impostando uStatus su WWAN_STATUS_FAILURE e PinType su WwanPinTypeNone. Nel caso in cui PUK1 sia bloccato, i driver miniport devono inviare un NDIS_STATUS_WWAN_READY_INFO con ReadyState impostato su WwanReadyStateBadSim.
Risposta alle richieste WwanPinOperationEnable, WwanPinOperationDisable o WwanPinOperationChange
Quando i driver miniport usano la notifica di NDIS_STATUS_WWAN_PIN_INFO per rispondere a WwanPinOperationEnable, WwanPinOperationDisable e WwanPinOperationChange, devono implementare le operazioni seguenti:
Per le richieste riuscite, i driver miniport devono impostare uStatus su WWAN_STATUS_SUCCESS. Per altri membri in WWAN_PIN_INFO, vedere le circostanze seguenti.
I driver miniport devono impostare uStatus su WWAN_STATUS_SUCCESS per le operazioni di abilitazione e disabilitazione pin quando il PIN è già nello stato richiesto. I driver Miniport devono impostare PinType su WwanPinTypeNone. Gli altri membri vengono ignorati.
Quando una modalità PIN viene modificata da disabilitata a abilitata, lo stato del PIN deve essere WwanPinStateNone.
Se PIN1 è abilitato, lo stato del PIN diventerà WwanPinStateEnter quando l'alimentazione viene ciclica nel dispositivo MB.
Per tutti gli altri PIN, lo stato del PIN può cambiare da WwanPinStateNone a WwanPinStateEnter a seconda delle condizioni specifiche del dispositivo MB.
PIN non supportato: se un'operazione PIN non è supportata dal dispositivo MB, i driver miniport devono impostare uStatus su WWAN_STATUS_NO_DEVICE_SUPPORT. Ad esempio, l'abilitazione e la disabilitazione di PIN2 non è in genere supportata dai dispositivi MB, quindi è necessario restituire il codice di errore precedente. Tutti gli altri membri vengono ignorati.
PIN deve essere immesso: se un'operazione PIN richiede l'immissione di un PIN, i driver miniport devono impostare uStatus su WWAN_STATUS_PIN_REQUIRED e PinType su WwanPinTypeXxx. Gli altri membri vengono ignorati.
Operazione di modifica DEL PIN: se il dispositivo MB limita la modifica del valore del PIN solo quando è in stato abilitato, è necessario restituire una richiesta di modifica dello stato disabilitato con WWAN_STATUS_PIN_DISABLED.
PIN Retrial: in caso di errore, i driver miniport devono impostare uStatus su WWAN_STATUS_FAILURE e PinType sullo stesso valore specificato in NDIS_WWAN_SET_PIN. Gli altri membri vengono ignorati, ad eccezione di AttemptsRemaining. Questo problema può verificarsi quando viene immesso un PIN non corretto.
Blocco PIN: il PIN viene bloccato quando il numero di TentativiRemaining è zero. Se l'operazione di sblocco del PIN non è disponibile, i driver miniport devono impostare uStatus su WWAN_STATUS_FAILURE e PinType su WwanPinTypeNone. I tentativiRemaining devono essere impostati su 0 e tutti gli altri membri vengono ignorati.
Nota Se il dispositivo MB supporta operazioni di sblocco del PIN, i driver miniport devono seguire il passaggio di sblocco del PIN per rispondere alla richiesta.
Sblocco DEL PIN: il PIN viene bloccato quando AttemptsRemaining è zero. Per sbloccare il PIN, il dispositivo MB può richiedere un PUK corrispondente, se applicabile. In questo caso, i driver miniport devono impostare uStatus su WWAN_STATUS_FAILURE, PinType sul PUK WwanPinTypexxxcorrispondente, PinState su WwanPinStateEnter e AttemptsRemaining deve avere il numero di tentativi consentiti per l'immissione di un PUK valido.
Se il blocco del PIN comporta il blocco del dispositivo MB o della SIM, i driver miniport devono inviare una notifica di evento con ReadyState impostato su WwanReadyStateDeviceLocked.
Se è presente un contesto PDP attivo al momento del blocco PIN1, i driver miniport devono disattivare il contesto PDP e inviare notifiche al sistema operativo sulla disattivazione PDP e sulla modifica dello stato del collegamento.
Requisiti
Versione |
Disponibile in Windows 7 e versioni successive di Windows. |
Intestazione |
Ndis.h |