NDIS_WWAN_PREFERRED_PROVIDERS-Struktur (ndiswwan.h)
Die NDIS_WWAN_PREFERRED_PROVIDERS-Struktur stellt eine Liste der bevorzugten Anbieter dar, einschließlich der Anzahl der Anbieter in der Liste.
Syntax
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;
Member
Header
Der Header mit Typ-, Revisions- und Größeninformationen zur NDIS_WWAN_PREFERRED_PROVIDERS-Struktur. Der MB-Dienst legt den Header mit den Werten fest, die in der folgenden Tabelle angezeigt werden, wenn er die Datenstruktur für Setvorgänge an den Miniporttreiber sendet. Miniporttreiber müssen den Header mit den gleichen Werten festlegen, wenn sie die Datenstruktur an den MB-Dienst senden.
| Headerunterelement | Wert |
|---|---|
| Typ | NDIS_OBJECT_TYPE_DEFAULT |
| Revision | NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
| Size | sizeof(NDIS_WWAN_PREFERRED_PROVIDERS) |
Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.
uStatus
Der Miniporttreiber muss dies auf WWAN_STATUS_SUCCESS für nicht angeforderte Ereignisse (NDIS_STATUS_INDICATION::RequestId = 0) festlegen. WWAN_STATUS_SUCCESS wird auch für die erfolgreiche Ausführung der NDIS_WWAN_SET_PREFERRED_PROVIDERS festgelegt.
Die folgende Tabelle enthält weitere mögliche Fehler status Codes (andere Member müssen nicht vom Miniporttreiber aktualisiert werden).
| Wert | Bedeutung |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | Für das Gerät ist eine PIN-Werteingabe erforderlich. |
| WWAN_STATUS_READ_FAILURE | Fehler beim Lesen von Informationen vom Gerät oder sim-Karte oder beidem. Für die SIM-Karte sind beispielsweise keine Bevorzugten Anbieterinformationen bereitgestellt. |
| WWAN_STATUS_BAD_SIM | Eine ungültige SIM-Karte wurde erkannt. |
| WWAN_STATUS_SIM_NOT_INSERTED | SIM nicht in das Gerät eingefügt. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Eine set-Anforderung wird nicht unterstützt. |
PreferredListHeader
Ein formatiertes WWAN_LIST_HEADER -Objekt, das eine Liste der bevorzugten Anbieter darstellt, einschließlich der Anzahl der Anbieter in der Liste.
Diese verweisen auf die Liste der WWAN_PROVIDER2 mithilfe der WWAN_LIST_HEADER-Struktur. WwanDataClass-Flags beschreiben die Präferenz der spezifischen Datenzugriffstechnologie und können auf eine beliebige Kombination innerhalb der eigenen Mobilfunkklasse festgelegt werden.
Die Antwort auf das Festlegen OID_WWAN_PREFERRED_PROVIDERS Anforderungen müssen null Elemente im PreferenceListHeader enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | ndiswwan.h (include Ndiswwan.h) |