structure WWAN_PACKET_SERVICE (wwan.h)
La structure WWAN_PACKET_SERVICE représente l’état de la 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 de l’attachement ou du détachement de paquets. 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 une 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 auprès d’un réseau, lorsqu’il n’existe aucune classe de données, ou lorsque 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 OU au niveau du bit de WWAN_DATA_CLASS_HSDPA et WWAN_DATA_CLASS_HSUPA.
Les pilotes Miniport doivent définir ce membre avec une valeur valide et envoyer la notification appropriée lorsque l’appareil change de 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 ne fait pas partie des valeurs prédéfinies dans le membre WwanDataClass de WWAN_DEVICE_CAPS.
FrequencyRange
Valeur WWAN_5G_FREQUENCY_RANGE qui spécifie les plages de fréquences que l’appareil utilise. Ce membre est valide uniquement 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 (TAI) unique actuelle. Ce champ est utilisé uniquement pour NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF sera utilisé s’il est inconnu. Inconnu 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 qu’il utilise MBIM 3.0 ou une version antérieure.
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 qui sont signalées avec les fonctionnalités de l’appareil pour afficher l’intersection des choix disponibles pour l’utilisateur.
Si un appareil prend également en charge une classe de données autre que les valeurs prédéfinies dans le membre WwanDataClass de WWAN_DEVICE_CAPS, le pilote miniport doit définir l’indicateur de WWAN_DATA_CLASS_CUSTOM avec le masque de bits approprié défini pour la classe de données dans ce membre.
Interroger et définir des requêtes OID ainsi que des événements status non sollicités utilisent le membre uNwError. S’il n’y a pas d’erreur spécifique au réseau ou si l’erreur propre au réseau n’est pas connue, les pilotes miniport doivent définir ce membre sur zéro. La section « Structure d’indication d’état » de la sémantique opérationnelle mo montre les valeurs d’échec d’attachement de paquets ou de détachement de paquets qui sont définies dans la spécification 3GPP TS 24.008.
Les points suivants fournissent des instructions sur le retour d’erreur spécifique au réseau dans différents scénarios :
- Si l’opération d’attachement de paquets échoue en raison d’une erreur propre au réseau, les pilotes miniport doivent retourner l’erreur spécifique au réseau en réponse aux demandes de requête . 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 propre au réseau.
- Si une demande de jeu échoue, les pilotes miniport doivent retourner le code d’erreur propre 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 propre au réseau.
- Chaque fois que l’état d’inscription de l’appareil change parce que le paquet réseau détache l’appareil, les événements status 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 sur le code d’erreur propre au réseau.
Les pilotes miniport doivent signaler le code de cause le plus tôt possible instance. 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 réseau, le pilote miniport doit le signaler à ce moment-là.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| En-tête | wwan.h (inclure Wwan.h) |