struttura WWAN_PACKET_SERVICE (wwan.h)
La struttura WWAN_PACKET_SERVICE rappresenta lo stato di allegato del servizio pacchetti del dispositivo MB.
Sintassi
typedef struct _WWAN_PACKET_SERVICE {
ULONG uNwError;
WWAN_PACKET_SERVICE_STATE PacketServiceState;
ULONG AvailableDataClass;
ULONG CurrentDataClass;
WWAN_5G_FREQUENCY_RANGE FrequencyRange;
ULONG CurrentDataSubClass;
WWAN_SINGLE_TAI CurrentTai;
ULONG Rel3GppVer;
} WWAN_PACKET_SERVICE, *PWWAN_PACKET_SERVICE;
Membri
uNwError
Errore specifico della rete, in caso di errore di collegamento di pacchetti o scollegamento di pacchetti. Per altre informazioni su questo membro, vedere la sezione "Osservazioni" seguente.
PacketServiceState
Stato del servizio pacchetti del dispositivo.
AvailableDataClass
Bitmap che rappresenta le classi di dati disponibili per il dispositivo nella rete corrente. Per un elenco dettagliato dei valori, vedere il membro WwanDataClass di WWAN_DEVICE_CAPS.
I driver Miniport devono impostare questo membro su WWAN_DATA_CLASS_NONE quando il dispositivo non è registrato in una rete o quando non è disponibile alcuna classe di dati o quando la classe di dati supportata non è disponibile. I driver Miniport devono impostare questo membro con un valore valido quando il dispositivo viene registrato in una rete.
CurrentDataClass
Valore singolo del membro WwanDataClass in WWAN_DEVICE_CAPS che rappresenta la classe dati attualmente utilizzata dal dispositivo.
Per tutti i servizi dati, ad eccezione di HSPA, i driver miniport devono impostare questo membro su un singolo valore WWAN_DATA_CLASS_XXX. Per i servizi dati HSPA, i driver miniport devono specificare un OR bit per bit di WWAN_DATA_CLASS_HSDPA e WWAN_DATA_CLASS_HSUPA.
I driver Miniport devono impostare questo membro con un valore valido e inviare la notifica appropriata quando il dispositivo cambia servizi, ad esempio da 1xRTT a 1xEV-DO.
I driver Miniport devono impostare questo membro su WWAN_DATA_CLASS_CUSTOM se la classe di dati non è uno dei valori predefiniti nel membro WwanDataClass di WWAN_DEVICE_CAPS.
FrequencyRange
Valore WWAN_5G_FREQUENCY_RANGE che specifica gli intervalli di frequenza usati dal dispositivo. Questo membro è valido solo se currentDataClass è WWAN_DATA_CLASS_5G_NSA o WWAN_DATA_CLASS_SA.
CurrentDataSubClass
Questo campo viene utilizzato solo per NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
CurrentTai
Struttura WWAN_SINGLE_TAI che rappresenta l'identità dell'area di rilevamento (TAI) corrente. Questo campo viene utilizzato solo per NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF verrà usato se sconosciuto. Sconosciuto indica che MBIM_TLV_TYPE_3GPP_REL_VERSION non è contenuto in MBIM_PACKET_SERVICE_INFO_V3, il dispositivo restituisce direttamente 0xFFFFFFFF oppure il dispositivo usa MBIM 3.0 o versione precedente.
Osservazioni
Lo stato corrente del servizio di collegamento di pacchetti si riflette in genere nell'interfaccia utente del dispositivo.
Il servizio MB combina le classi di dati rappresentate in AvailableDataClass con le classi di dati supportate segnalate con le funzionalità del dispositivo per visualizzare l'intersezione delle scelte disponibili per l'utente.
Se un dispositivo supporta anche una classe di dati diversa dai valori predefiniti nella membro WwanDataClass di WWAN_DEVICE_CAPS, il driver miniport deve impostare il flag WWAN_DATA_CLASS_CUSTOM insieme alla maschera di bit appropriata definita per la classe di dati in questo membro.
query e impostare le richieste OID nonché gli eventi di stato non richiesti usano il membro uNwError. Se non è presente alcun errore di rete o se non è noto l'errore specifico della rete, i driver miniport devono impostare questo membro su zero. La sezione "Status Indication Structure" in MB Operational Semantics mostra i valori di errore del codice definiti nella specifica 3GPP TS 24.008.
I punti seguenti forniscono linee guida sulla restituzione di un errore specifico di rete in scenari diversi:
- Se l'operazione di collegamento di pacchetti non riesce a causa di un errore specifico della rete, i driver miniport devono restituire l'errore specifico della rete in risposta alle richieste di query. In questo caso, i driver miniport devono impostare il membro uStatus della struttura NDIS_WWAN_PACKET_SERVICE_STATE su WWAN_STATUS_SUCCESS e impostare il membro uNwError sul codice di errore specifico della rete.
- Se una richiesta di impostata ha esito negativo, i driver miniport devono restituire il codice di errore specifico della rete. In questo caso, i driver miniport devono impostare il membro uStatus della struttura NDIS_WWAN_PACKET_SERVICE_STATE su WWAN_STATUS_FAILURE e impostare il membro uNwError sul codice di errore specifico della rete.
- Ogni volta che lo stato di registrazione del dispositivo cambia perché il pacchetto di rete scollega il dispositivo, 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_PACKET_SERVICE_STATE su WWAN_STATUS_SUCCESS e impostare il membro uNwError sul codice di errore specifico della rete.
I driver Miniport devono segnalare il codice di causa nella prima istanza possibile. Ad esempio, se il dispositivo MB rileva uno di questi codici quando si tenta di registrare il dispositivo con un provider di rete, il driver miniport dovrebbe segnalarlo in quel momento.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| intestazione | wwan.h (include Wwan.h) |