structure NDIS_WWAN_PREFERRED_PROVIDERS (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 affichées dans le tableau suivant lorsqu’il envoie la structure de données au pilote miniport pour définir opérations. 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 définir cette valeur sur WWAN_STATUS_SUCCESS pour les événements non sollicités (NDIS_STATUS_INDICATION ::RequestId = 0). WWAN_STATUS_SUCCESS est également défini pour l’exécution réussie du NDIS_WWAN_SET_PREFERRED_PROVIDERS.
Le tableau suivant présente d’autres codes d’état d’erreur possibles (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 | Échec de la lecture des informations à partir d’un appareil ou d’une carte SIM, ou les deux. Par exemple, la 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 | Un défini demande n’est pas pris 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.
Celles-ci pointent vers la liste des WWAN_PROVIDER2 à l’aide de la structure WWAN_LIST_HEADER. WwanDataClass indicateurs 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 à ensemble de requêtes OID_WWAN_PREFERRED_PROVIDERS doit contenir zéro élément dans le PreferenceListHeader .
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | ndiswwan.h (include Ndiswwan.h) |