struttura NDIS_WWAN_PACKET_SERVICE_STATE (ndiswwan.h)
La struttura NDIS_WWAN_PACKET_SERVICE_STATE rappresenta lo stato di allegato del servizio pacchetti del dispositivo MB.
Sintassi
typedef struct _NDIS_WWAN_PACKET_SERVICE_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_PACKET_SERVICE PacketService;
} NDIS_WWAN_PACKET_SERVICE_STATE, *PNDIS_WWAN_PACKET_SERVICE_STATE;
Members
Header
Intestazione con informazioni su tipo, revisione e dimensioni sulla struttura NDIS_WWAN_PACKET_SERVICE_STATE. Il servizio MB imposta l'intestazione con i valori visualizzati nella tabella seguente quando invia la struttura dei dati al driver miniport per le operazioni set . I driver Miniport devono impostare l'intestazione con gli stessi valori quando inviano la struttura dei dati al servizio MB.
| Sottomembero intestazione | Valore |
|---|---|
| Tipo | NDIS_OBJECT_TYPE_DEFAULT |
| Revisione | Windows 10, i driver miniport versione 1903 che supportano 5G impostano questa opzione su NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2. I driver Miniport che non supportano il 5G o che sono per le versioni precedenti di Windows impostano questa opzione su NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1. |
| Dimensione | sizeof(NDIS_WWAN_PACKET_SERVICE_STATE) |
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
uStatus
Un driver miniport deve impostarlo su WWAN_STATUS_SUCCESS per gli eventi non richiesti (NDIS_STATUS_INDICATION::RequestId = 0).
WWAN_STATUS_SUCCESS viene impostato anche per l'esecuzione corretta di richieste di set e query .
WWAN_STATUS_SUCCESS devono essere restituiti dal driver miniport, se lo stato richiesto e lo stato corrente sono uguali per una richiesta impostata .
La tabella seguente illustra gli altri codici di stato di errore possibili.
| Valore | Significato |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | Il dispositivo richiede l'input del valore PIN. |
| WWAN_STATUS_FAILURE | Impossibile ottenere o impostare lo stato del servizio pacchetti. |
| WWAN_STATUS_NOT_INITIALIZED | L'operazione non è riuscita perché il dispositivo è in fase di inizializzazione. Ripetere l'operazione dopo che lo stato pronto del dispositivo viene modificato in WwanReadyStateInitialized. |
| WWAN_STATUS_SIM_NOT_INSERTED | L'operazione non è riuscita perché la scheda SIM non è stata inserita completamente nel dispositivo. |
| WWAN_STATUS_BAD_SIM | L'operazione non è riuscita perché è stata rilevata una scheda SIM non valida. |
I driver Miniport possono restituire i codici di errore (oltre a quelli elencati sopra) illustrati nella tabella seguente nel caso in cui una richiesta di set di collegamento di pacchetti non riesca.
| Valore | Significato |
|---|---|
| WWAN_STATUS_FAILURE | Collegamento di pacchetti o scollegamento di pacchetti non riuscito. Altre informazioni sono impostate nel membro uNwError della struttura WWAN_PACKET_SERVICE. Per altri errori di WWAN_STATUS_XXX, uNwError deve essere impostato su zero. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | Il dispositivo non consente di impostare lo stato del servizio pacchetti a causa di un errore di attivazione del servizio o di una sottoscrizione scaduta. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Il provider non è visibile per le operazioni del servizio pacchetti. |
| WWAN_STATUS_NOT_REGISTERED | Lo stato del dispositivo non è registrato per eseguire un'operazione di collegamento di pacchetti. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Il servizio set packet non è supportato da questo dispositivo basato su CDMA. |
| WWAN_STATUS_RADIO_POWER_OFF | Impossibile collegare pacchetti perché la radio è disattivata. |
| WWAN_STATUS_SIM_NOT_INSERTED | Non viene inserita una scheda SIM. |
| WWAN_STATUS_BAD_SIM | Viene rilevata una scheda SIM non valida. |
PacketService
Oggetto WWAN_PACKET_SERVICE formattato che rappresenta lo stato di allegato del servizio pacchetti del dispositivo MB.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | ndiswwan.h (include Ndiswwan.h) |