Partager via


NDIS_WWAN_PREFERRED_PROVIDERS structure (ndiswwan.h)

La structure NDIS_WWAN_PREFERRED_PROVIDERS représente une liste de fournisseurs préférés, y compris le nombre de fournisseurs dans la liste.

Syntaxe

typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_LIST_HEADER   PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;

Membres

Header

En-tête avec des informations de type, de révision et de taille sur la structure NDIS_WWAN_PREFERRED_PROVIDERS. 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 NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1
Taille sizeof(NDIS_WWAN_PREFERRED_PROVIDERS)
 

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

uStatus

Le 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_PREFERRED_PROVIDERS.

Le tableau suivant montre d’autres erreurs possibles status codes (les autres membres n’ont pas besoin d’être mis à jour par le pilote miniport).

Valeur Signification
WWAN_STATUS_PIN_REQUIRED L’appareil nécessite une entrée de valeur de code confidentiel.
WWAN_STATUS_READ_FAILURE La lecture des informations de l’appareil ou de la carte SIM carte, ou les deux, a échoué. Par exemple, l’carte SIM n’a pas d’informations sur les fournisseurs préférés approvisionnées.
WWAN_STATUS_BAD_SIM Une carte SIM incorrecte a été détectée.
WWAN_STATUS_SIM_NOT_INSERTED Carte SIM non insérée dans l’appareil.
WWAN_STATUS_NO_DEVICE_SUPPORT Une requête définie n’est pas prise en charge.

PreferredListHeader

Objet WWAN_LIST_HEADER mis en forme qui représente une liste de fournisseurs préférés, y compris le nombre de fournisseurs dans la liste.

Ils pointent vers la liste des WWAN_PROVIDER2 à l’aide de la structure WWAN_LIST_HEADER. Les indicateurs WwanDataClass décrivent la préférence de la technologie d’accès aux données spécifique et peuvent être définis sur n’importe quelle combinaison au sein de sa propre classe cellulaire.

La réponse pour définir OID_WWAN_PREFERRED_PROVIDERS demandes doit contenir zéro élément dans preferenceListHeader.

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_LIST_HEADER