NDIS_WWAN_REGISTRATION_STATE structure (ndiswwan.h)

  • Article

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)

Voir aussi

NDIS_OBJECT_HEADER

WWAN_REGISTRATION_STATE