struttura NDIS_WWAN_CONTEXT_STATE (ndiswwan.h)
La struttura NDIS_WWAN_CONTEXT_STATE rappresenta lo stato del contesto PDP (Packet Data Protocol) del dispositivo MB.
Sintassi
typedef struct _NDIS_WWAN_CONTEXT_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;
Membri
Header
Intestazione con informazioni di tipo, revisione e dimensioni sulla struttura NDIS_WWAN_CONTEXT_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 impostate. I driver Miniport devono impostare l'intestazione con gli stessi valori quando inviano la struttura dei dati al servizio MB.
| Sottomembero intestazione | Valore |
|---|---|
| Digitare | NDIS_OBJECT_TYPE_DEFAULT |
| Revisione | I driver miniport di Windows 8 devono impostarlo su NDIS_WWAN_CONTEXT_STATE_REVISION_2. I driver miniport di Windows 7 devono impostarlo su NDIS_WWAN_CONTEXT_STATE_REVISION_1. |
| Grandezza | sizeof(NDIS_WWAN_CONTEXT_STATE) |
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
uStatus
Stato dell'attivazione del contesto o dell'operazione di disattivazione. Nella tabella seguente vengono illustrati i valori possibili per questo membro.
| Valore | Significato |
|---|---|
| WWAN_STATUS_SUCCESS | Attivazione o disattivazione del contesto completata. |
| WWAN_STATUS_FAILURE | Operazione non riuscita. I driver Miniport possono restituire questo valore se il contesto è già stato attivato. |
| WWAN_STATUS_PIN_REQUIRED | L'operazione non è riuscita perché il dispositivo richiede un PIN. |
| WWAN_STATUS_BAD_SIM | L'operazione non è riuscita perché è stata rilevata una scheda SIM non valida. |
| WWAN_STATUS_SIM_NOT_INSERTED | L'operazione non è riuscita perché la scheda SIM non è stata inserita completamente nel dispositivo. |
| 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. |
I driver Miniport possono restituire i codici di errore seguenti (oltre a quelli descritti in precedenza) solo in caso di un'operazione di attivazione PDP impostata non riuscita.
| Valore | Significato |
|---|---|
| WWAN_STATUS_RADIO_POWER_OFF | L'operazione non è riuscita perché la radio è attualmente disattivata. Questo codice di errore deve essere restituito solo in risposta a una richiesta di impostata OID_WWAN_CONNECT. Se lo stato della radio è disattivato, il driver miniport deve rispondere alle richieste di OID_WWAN_CONNECT query con WWAN_STATUS_SUCCESS e specificare lo stato del contesto corrente come WwanActivationStateDeactivated. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | L'operazione non è riuscita perché la sottoscrizione è scaduta o il dispositivo non consente l'attivazione PDP. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Operazione non riuscita perché il provider di servizi non è attualmente visibile. |
| WWAN_STATUS_MAX_ACTIVATED_CONTEXTS | L'operazione non è riuscita perché è stato raggiunto il numero massimo di contesti attivati. |
| WWAN_STATUS_INVALID_ACCESS_STRING | L'operazione non è riuscita perché la stringa di accesso non è valida. |
| WWAN_STATUS_INVALID_USER_NAME_PWD | L'operazione non è riuscita perché il nome utente e/o la password specificati non sono validi. Il codice di errore specifico della rete può essere disponibile in uNwError . |
| WWAN_STATUS_PACKET_SVC_DETACHED | Operazione non riuscita perché il servizio pacchetti è scollegato. |
| WWAN_STATUS_NOT_REGISTERED | L'operazione non è riuscita perché il dispositivo non è nello stato registrato per eseguire l'attivazione PDP. |
| WWAN_STATUS_VOICE_CALL_IN_PROGRESS | L'operazione non è riuscita e non può procedere con l'attivazione PDP perché è attualmente in corso una chiamata vocale. Questo valore si applica solo ai dispositivi con classe vocale è impostato su WwanVoiceClassSeparateVoiceData. |
| WWAN_STATUS_CONTEXT_NOT_ACTIVATED | L'operazione non è riuscita perché il contesto identificato da ConnectionId non è il contesto attualmente attivato. |
ContextState
Oggetto WWAN_CONTEXT_STATE formattato che rappresenta lo stato del contesto PDP (Packet Data Protocol) del dispositivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| intestazione | ndiswwan.h (include Ndiswwan.h) |