NDIS_WWAN_CONTEXT_STATE struttura (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;
Members
Header
Intestazione con tipo, revisione e dimensioni relative alla struttura NDIS_WWAN_CONTEXT_STATE. Il servizio MB imposta l'intestazione con i valori visualizzati nella tabella seguente quando invia la struttura 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.
| Sottomember intestazione | Valore |
|---|---|
| Tipo | NDIS_OBJECT_TYPE_DEFAULT |
| Revisione | Windows 8 i driver miniport devono impostarlo su NDIS_WWAN_CONTEXT_STATE_REVISION_2. I driver miniport windows 7 devono impostare questa opzione su NDIS_WWAN_CONTEXT_STATE_REVISION_1. |
| Dimensione | 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. La tabella seguente mostra i valori possibili per questo membro.
| Valore | Significato |
|---|---|
| WWAN_STATUS_SUCCESS | Attivazione del contesto o disattivazione riuscita. |
| 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 | 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. Riprovare l'operazione dopo lo stato pronto del dispositivo cambia 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 non riuscita.
| Valore | Significato |
|---|---|
| WWAN_STATUS_RADIO_POWER_OFF | Operazione non riuscita perché la radio è attualmente disattivata. Questo codice di errore deve essere restituito solo in risposta a una richiesta impostata di OID_WWAN_CONNECT. Se lo stato di radio è disattivato, il driver miniport deve rispondere alle richieste di query OID_WWAN_CONNECT con WWAN_STATUS_SUCCESS e specificare lo stato di 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 | 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 forniti 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 viene 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é una chiamata vocale è attualmente in corso. 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | ndiswwan.h (include Ndiswwan.h) |