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) |