struttura WWAN_CONTEXT_STATE (wwan.h)

Articolo
02/07/2025

La struttura WWAN_CONTEXT_STATE rappresenta lo stato del contesto PDP (Packet Data Protocol) del dispositivo MB.

Sintassi

typedef struct _WWAN_CONTEXT_STATE {
  ULONG                    uNwError;
  ULONG                    ConnectionId;
  WWAN_ACTIVATION_STATE    ActivationState;
  WWAN_VOICE_CALL_STATE    VoiceCallState;
  WWAN_IP_TYPE             IPType;
  WWAN_CONNECTION_MEDIA    ConnectionMedia;
  WCHAR                    AccessString[WWAN_ACCESSSTRING_LEN];
  WWAN_SINGLE_NSSAI        Snssai;
  ULONG                    FoundMatchingConnectionId;
  WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;

Membri

uNwError

Errore specifico della rete. La tabella seguente illustra i valori di errore di connessione, come documentato nella specifica 3GPP TS 24.008 .

Codice causa 3GPP 24.008	Interpretazione del codice della causa
8 - Operatore determinato a barre	Il servizio dati dei pacchetti è bloccato dall'operatore .
26 - Risorse insufficienti	Il contesto non può essere attivato a causa di risorse insufficienti in rete.
27 - Nome del punto di accesso mancante o sconosciuto	Nella richiesta di attivazione non viene fornito alcun APN o APN sconosciuto.
29 , 30, 31 - Autenticazione utente non riuscita	Nome utente o password errato specificato nella richiesta di attivazione.
32 - Opzione di servizio non supportata	LA RETE non è supportata da NESSUNA.
33 - Opzione di servizio richiesta non sottoscritta	Il servizio richiesto non è sottoscritto dall'utente.
34 - L'opzione di servizio non è temporaneamente in ordine	Il servizio dati dei pacchetti non è temporaneamente in ordine. L'utente deve riprovare in un secondo momento.
43 - Contesto PDP (Unknown Packet Data Protocol)	Nella richiesta di attivazione non viene fornito alcun APN o APN sconosciuto.

ConnectionId

Il servizio MB specifica un valore per questo membro al momento della richiesta di connessione tramite OID_WWAN_CONNECT. I driver Miniport devono copiare questo valore e usarlo quando notificano al servizio MB le modifiche successive dello stato di connessione.

ActivationState

Stato di attivazione corrente del dispositivo.

VoiceCallState

Stato della chiamata vocale corrente del dispositivo.

IPType

Valore dell'enumerazione WWAN_IP_TYPE che specifica il tipo di IP.

ConnectionMedia

Tipo di supporto per un contesto/sessione stabilito.

AccessString[WWAN_ACCESSSTRING_LEN]

APN/DNN selezionato per un contesto/sessione stabilito.

Snssai

Struttura WWAN_SINGLE_NSSAI che rappresenta una singola informazione di assistenza selezione sezione di rete (NSSAI).

FoundMatchingConnectionId

Valido solo se lo stato è WWAN_STATUS_SESSION_ALREADY_EXISTS.

TrafficParameters

Struttura WWAN_OFFSET_SIZE_ELEMENT. Valido solo se lo stato è WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION. I primi 4 byte sono l'offset di DataBuffer contenente i dati non elaborati di MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, in byte, calcolati dall'inizio di WWAN_SET_CONTEXT_STATE. I secondi 4 byte sono le dimensioni dei dati non elaborati di MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, in byte.

Osservazioni

Impostare le richieste OID e gli eventi di stato non richiesti usano il membro uNwError. Se non è presente alcun errore specifico di rete o l'errore specifico della rete non è noto, i driver miniport devono impostare questo membro su 0.

I punti seguenti forniscono linee guida sulla restituzione di un errore specifico di rete in scenari diversi:

Se una richiesta di set ha esito negativo, i driver miniport devono restituire il codice di errore specifico della rete. In questo caso, il driver miniport deve impostare il membro uStatus della struttura NDIS_WWAN_CONTEXT_STATE su WWAN_STATUS_FAILURE o un errore più specifico, ad esempio WWAN_STAUS_INVALID_ACCESS_STRING o WWAN_STATUS_INVALID_USER_NAME_PWD, e impostare il membro uNwError sul codice di errore specifico della rete.
Ogni volta che lo stato di attivazione del contesto di dispositivo cambia a causa della disattivazione del contesto avviato dalla rete, gli eventi di stato non richiesti devono includere l'errore specifico della rete. In questo caso, il driver miniport deve impostare il membro uStatus della struttura NDIS_WWAN_CONTEXT_STATE su WWAN_STATUS_SUCCESS e impostare il membro uNwError sul codice di errore specifico della rete.

I driver Miniport possono fornire codici di errore aggiuntivi, come definito dalla specifica standard GSM dei codici di errore di attivazione del contesto restituiti dalla rete. Ad esempio, i driver miniport possono comunicare i codici di errore di attivazione del contesto TS 24.008 della specifica 3GPP, ad esempio il codice di errore 8 (barra determinata dall'operatore), al servizio MB tramite il membro uNwError. Non sono disponibili standard per i codici di errore specifici della rete basata su CDMA. I dispositivi e le reti basati su CDMA possono restituire informazioni sul codice di errore specifiche della rete usando il membro uNwError.

In caso di risposta al NDIS_WWAN_SET_CONTEXT_STATE, usare questo membro per fornire codici di errore aggiuntivi restituiti dalla rete.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 8 e versioni successive di Windows.
intestazione	wwan.h (include Wwan.h)

Vedere anche

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE

Condividi tramite