structure NDIS_WWAN_PACKET_SERVICE_STATE (ndiswwan.h)
La structure NDIS_WWAN_PACKET_SERVICE_STATE représente l’état de la pièce jointe du service de paquets de l’appareil Mo.
Syntaxe
typedef struct _NDIS_WWAN_PACKET_SERVICE_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_PACKET_SERVICE PacketService;
} NDIS_WWAN_PACKET_SERVICE_STATE, *PNDIS_WWAN_PACKET_SERVICE_STATE;
Membres
Header
En-tête avec des informations de type, de révision et de taille sur la structure NDIS_WWAN_PACKET_SERVICE_STATE. Le service Mo définit l’en-tête avec les valeurs indiquées dans le tableau suivant lorsqu’il envoie la structure de données au pilote miniport pour les opérations de définition . Les pilotes Miniport doivent définir l’en-tête avec les mêmes valeurs lorsqu’ils envoient la structure de données au service Mo.
| Sous-membre d’en-tête | Valeur |
|---|---|
| Type | NDIS_OBJECT_TYPE_DEFAULT |
| Révision | Windows 10, les pilotes miniport de la version 1903 qui prennent en charge la 5G définissent cette option sur NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2. Les pilotes Miniport qui ne prennent pas en charge la 5G ou qui sont destinés à des versions antérieures de Windows définissent ce paramètre sur NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1. |
| Taille | sizeof(NDIS_WWAN_PACKET_SERVICE_STATE) |
Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.
uStatus
Un pilote miniport doit le définir sur WWAN_STATUS_SUCCESS pour les événements non sollicités (NDIS_STATUS_INDICATION ::RequestId = 0).
WWAN_STATUS_SUCCESS est également défini pour une exécution réussie des requêtes de jeu et de requête .
WWAN_STATUS_SUCCESS doivent être retournés par le pilote miniport, si l’état demandé et l’état actuel sont identiques pour une demande définie .
Le tableau suivant montre les autres erreurs possibles status codes.
| Valeur | Signification |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | L’appareil nécessite une entrée de valeur de code confidentiel. |
| WWAN_STATUS_FAILURE | Impossible d’obtenir ou de définir l’état du service de paquets. |
| WWAN_STATUS_NOT_INITIALIZED | L’opération a échoué, car l’appareil est en cours d’initialisation. Réessayez l’opération une fois l’état prêt de l’appareil passé à WwanReadyStateInitialized. |
| WWAN_STATUS_SIM_NOT_INSERTED | L’opération a échoué, car le carte SIM n’a pas été entièrement inséré dans l’appareil. |
| WWAN_STATUS_BAD_SIM | L’opération a échoué car une mauvaise carte SIM a été détectée. |
Les pilotes Miniport peuvent retourner les codes d’erreur (en plus de ceux répertoriés ci-dessus) indiqués dans le tableau suivant en cas d’échec d’une demande de jeu d’attachement de paquets.
| Valeur | Signification |
|---|---|
| WWAN_STATUS_FAILURE | Échec de l’attachement ou du détachement de paquets. Pour plus d’informations, consultez uNwError membre de WWAN_PACKET_SERVICE structure. Pour les autres erreurs WWAN_STATUS_XXX, uNwError doit être défini sur zéro. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | L’appareil n’autorise pas la définition de l’état du service de paquets en raison d’un échec d’activation du service ou d’un abonnement expiré. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Le fournisseur n’est pas visible pour les opérations de service de paquets. |
| WWAN_STATUS_NOT_REGISTERED | L’appareil n’est pas dans l’état inscrit pour effectuer une opération d’attachement de paquets. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Le service de paquets SET n’est pas pris en charge par cet appareil basé sur CDMA. |
| WWAN_STATUS_RADIO_POWER_OFF | Impossible d’attacher des paquets, car la radio est désactivée. |
| WWAN_STATUS_SIM_NOT_INSERTED | Une carte SIM n’est pas insérée. |
| WWAN_STATUS_BAD_SIM | Une mauvaise carte SIM est détectée. |
PacketService
Objet WWAN_PACKET_SERVICE mis en forme qui représente l’état de pièce jointe du service de paquets de l’appareil Mo.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| En-tête | ndiswwan.h (include Ndiswwan.h) |