NDIS_WWAN_REGISTRATION_STATE structure (ndiswwan.h)
La structure NDIS_WWAN_REGISTRATION_STATE représente l’état d’inscription de l’appareil Mo.
Syntaxe
typedef struct _NDIS_WWAN_REGISTRATION_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_REGISTRATION_STATE RegistrationState;
} NDIS_WWAN_REGISTRATION_STATE, *PNDIS_WWAN_REGISTRATION_STATE;
Membres
Header
En-tête avec des informations de type, de révision et de taille sur la structure NDIS_WWAN_REGISTRATION_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 un appareil 5G doivent le définir sur NDIS_WWAN_REGISTRATION_STATE_REVISION_3. Windows 8 pilotes de miniport doivent le définir sur NDIS_WWAN_REGISTRATION_STATE_REVISION_2. Les pilotes windows 7 miniport doivent définir ce paramètre sur NDIS_WWAN_REGISTRATION_STATE_REVISION_1. |
| Taille | sizeof(NDIS_WWAN_REGISTRATION_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 du NDIS_WWAN_SET_REGISTER_STATE.
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 l’état d’inscription. |
| 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_BAD_SIM | L’opération a échoué car une mauvaise carte SIM a été détectée. |
| 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. |
Les pilotes Miniport peuvent retourner les codes d’erreur suivants (en plus de ceux répertoriés ci-dessus) uniquement en cas d’échec d’une opération de jeu d’activation PDP.
| Valeur | Signification |
|---|---|
| WWAN_STATUS_FAILURE | Impossible de définir l’état d’inscription. Des informations supplémentaires sont spécifiées dans uNwError . Pour les autres codes d’erreur, uNwError doit être défini sur 0. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Les appareils basés sur CDMA doivent retourner ce code d’erreur si une demande d’inscription de jeu est destinée à l’inscription manuelle. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | Échec de l’activation du service. L’abonnement a expiré. L’appareil n’autorise pas la définition de l’état d’inscription. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Le fournisseur n’est pas visible pour l’inscription. Il s’agit d’une inscription manuelle. |
| WWAN_STATUS_INVALID_PARAMETERS | Si la demande est une inscription manuelle auprès d’un fournisseur interdit. |
| WWAN_STATUS_BUSY | L’appareil est occupé et ne peut pas modifier le mode d’inscription. Ce scénario peut se produire si l’appareil n’autorise pas la modification du mode d’inscription lorsqu’un contexte PDP est activé. |
RegistrationState
Objet WWAN_REGISTRATION_STATE mis en forme qui représente l’état d’inscription 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) |