structure WWAN_PACKET_SERVICE (wwan.h)
La structure WWAN_PACKET_SERVICE représente l’état de pièce jointe du service de paquets de l’appareil Mo.
Syntaxe
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;
Membres
uNwError
Erreur spécifique au réseau, en cas d’échec d’attachement de paquet ou de détachement de paquet. Pour plus d’informations sur ce membre, consultez la section « Remarques » suivante.
PacketServiceState
État du service de paquets de l’appareil.
AvailableDataClass
Bitmap qui représente les classes de données disponibles pour l’appareil dans le réseau actuel. Pour obtenir la liste détaillée des valeurs, consultez le membre WwanDataClass de WWAN_DEVICE_CAPS.
Les pilotes miniport doivent définir ce membre sur WWAN_DATA_CLASS_NONE lorsque l’appareil n’est pas inscrit sur un réseau, ou lorsqu’il n’existe aucune classe de données, ou quand la classe de données prise en charge n’est pas disponible. Les pilotes miniport doivent définir ce membre avec une valeur valide lorsque l’appareil est inscrit sur un réseau.
CurrentDataClass
Valeur unique du membre WwanDataClass dans WWAN_DEVICE_CAPS qui représente la classe de données actuellement utilisée par l’appareil.
Pour tous les services de données, à l’exception de HSPA, les pilotes miniport doivent définir ce membre sur une valeur de WWAN_DATA_CLASS_XXX unique. Pour les services de données HSPA, les pilotes miniport doivent spécifier un OR de WWAN_DATA_CLASS_HSDPA et de WWAN_DATA_CLASS_HSUPA au niveau du bit.
Les pilotes Miniport doivent définir ce membre avec une valeur valide et envoyer la notification appropriée lorsque l’appareil modifie les services, par exemple, de 1xRTT à 1xEV-DO.
Les pilotes miniport doivent définir ce membre sur WWAN_DATA_CLASS_CUSTOM si la classe de données n’est pas l’une des valeurs prédéfinies dans le WwanDataClass membre de WWAN_DEVICE_CAPS.
FrequencyRange
Valeur WWAN_5G_FREQUENCY_RANGE qui spécifie les plages de fréquences que l’appareil utilise. Ce membre n’est valide que si CurrentDataClass est WWAN_DATA_CLASS_5G_NSA ou WWAN_DATA_CLASS_SA.
CurrentDataSubClass
Ce champ est utilisé uniquement pour NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
CurrentTai
Structure WWAN_SINGLE_TAI représentant l’identité de zone de suivi unique (TAI) actuelle. Ce champ est utilisé uniquement pour NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF sera utilisé si inconnu. Cela signifie que MBIM_TLV_TYPE_3GPP_REL_VERSION n’est pas contenu dans MBIM_PACKET_SERVICE_INFO_V3, que l’appareil retourne directement 0xFFFFFFFF, ou que l’appareil utilise MBIM 3.0 ou plus.
Remarques
L’état actuel du service d’attachement de paquets est généralement reflété dans l’interface utilisateur de l’appareil.
Le service Mo combine les classes de données représentées dans AvailableDataClass avec les classes de données prises en charge signalées avec les fonctionnalités de l’appareil pour afficher l’intersection des choix disponibles à l’utilisateur.
Si un appareil prend également en charge une classe de données autre que les valeurs prédéfinies du WwanDataClass membre de WWAN_DEVICE_CAPS, le pilote miniport doit définir l’indicateur WWAN_DATA_CLASS_CUSTOM ainsi que le masque de bits approprié défini pour la classe de données dans ce membre.
requête et définir demandes OID ainsi que les événements d’état non sollicités utilisent le membre uNwError. S’il n’existe aucune erreur spécifique au réseau ou si l’erreur spécifique au réseau n’est pas connue, les pilotes miniport doivent définir ce membre sur zéro. La section « Structure de l’indication d’état » dans sémantique opérationnelle mo affiche l’attachement de paquets ou le détachement de paquets provoquent des valeurs d’échec de code définies dans la spécification 3GPP TS 24.008.
Les points suivants fournissent des instructions sur le renvoi d’une erreur spécifique au réseau dans différents scénarios :
- Si l’opération d’attachement de paquet échoue en raison d’une erreur spécifique au réseau, les pilotes miniport doivent renvoyer l’erreur spécifique au réseau en réponse à requête demandes. Dans ce cas, les pilotes miniport doivent définir le membre uStatus de la structure NDIS_WWAN_PACKET_SERVICE_STATE sur WWAN_STATUS_SUCCESS et définir le membre uNwError sur le code d’erreur spécifique au réseau.
- Si un défini demande échoue, les pilotes miniport doivent retourner le code d’erreur spécifique au réseau. Dans ce cas, les pilotes miniport doivent définir le membre uStatus de la structure NDIS_WWAN_PACKET_SERVICE_STATE sur WWAN_STATUS_FAILURE et définir le membre uNwError sur le code d’erreur spécifique au réseau.
- Chaque fois que l’état d’inscription de l’appareil change, car le paquet réseau détache l’appareil, les événements d’état non sollicités doivent inclure l’erreur spécifique au réseau. Dans ce cas, le pilote miniport doit définir le membre uStatus de la structure NDIS_WWAN_PACKET_SERVICE_STATE sur WWAN_STATUS_SUCCESS et définir le membre uNwError membre du code d’erreur spécifique au réseau.
Les pilotes miniport doivent signaler le code de cause au plus tôt possible. Par exemple, si l’appareil Mo rencontre l’un de ces codes lors de la tentative d’inscription de l’appareil auprès d’un fournisseur de réseau, le pilote miniport doit le signaler à ce moment-là.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | wwan.h (include Wwan.h) |