WWAN_PACKET_SERVICE struttura (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;
Members
uNwError
Errore specifico della rete, in caso di errore di collegamento a pacchetti o di scollegamento dei 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 dati o quando la classe dati supportata non è disponibile. I driver miniport devono impostare questo membro con un valore valido quando il dispositivo è registrato in una rete.
CurrentDataClass
Valore singolo del membro WwanDataClass in WWAN_DEVICE_CAPS che rappresenta la classe di dati attualmente usata 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 con 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 modifica i servizi, ad esempio da 1xRTT a 1xEV-DO.
I driver Miniport devono impostare questo membro su WWAN_DATA_CLASS_CUSTOM se la classe 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 usato solo per NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
CurrentTai
Struttura WWAN_SINGLE_TAI che rappresenta l'identità dell'area di rilevamento corrente (TAI). Questo campo viene usato solo per NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF verrà usato se sconosciuto. Sconosciuto significa che MBIM_TLV_TYPE_3GPP_REL_VERSION non è contenuto in MBIM_PACKET_SERVICE_INFO_V3, il dispositivo restituisce direttamente 0xFFFFFFFF o il dispositivo usa MBIM 3.0 o versione precedente.
Commenti
Lo stato del servizio di collegamento al pacchetto corrente viene in genere riflesso 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 del membro WwanDataClass di WWAN_DEVICE_CAPS, il driver miniport deve impostare il flag di WWAN_DATA_CLASS_CUSTOM insieme alla maschera di bit appropriata definita per la classe di dati in questo membro.
Eseguire query e impostare richieste OID e eventi di stato non richiesti usano il membro uNwError . Se non è presente alcun errore specifico di rete o non è noto l'errore specifico della rete, i driver miniport devono impostare questo membro su zero. La sezione "Struttura indicazione stato" in MB Operational Semantics mostra i valori di errore del codice di tipo 3GPP TS 24.008 relativi al collegamento a pacchetti o al scollegamento dei pacchetti.
I punti seguenti forniscono linee guida per la restituzione di errori specifici della rete in diversi scenari:
- Se l'operazione di collegamento dei pacchetti ha esito negativo 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 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 e quindi 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 al più presto 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 deve segnalarlo in quel momento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | wwan.h (include Wwan.h) |