NDIS_WWAN_REGISTRATION_STATE-Struktur (ndiswwan.h)
Die NDIS_WWAN_REGISTRATION_STATE-Struktur stellt den Registrierungsstatus des MB-Geräts dar.
Syntax
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;
Member
Header
Der Header mit Typ-, Revisions- und Größeninformationen zur NDIS_WWAN_REGISTRATION_STATE-Struktur. Der MB-Dienst legt den Header mit den Werten fest, die in der folgenden Tabelle angezeigt werden, wenn er die Datenstruktur für festgelegte Vorgänge an den Miniporttreiber sendet. Miniporttreiber müssen den Header mit den gleichen Werten festlegen, wenn sie die Datenstruktur an den MB-Dienst senden.
| Headerunterember | Wert |
|---|---|
| Typ | NDIS_OBJECT_TYPE_DEFAULT |
| Revision | Windows 10 sollten Miniporttreiber der Version 1903, die ein 5G-Gerät unterstützen, dies auf NDIS_WWAN_REGISTRATION_STATE_REVISION_3 festlegen. Windows 8 Miniporttreiber sollten sie auf NDIS_WWAN_REGISTRATION_STATE_REVISION_2 festlegen. Windows 7-Miniporttreiber sollten dies auf NDIS_WWAN_REGISTRATION_STATE_REVISION_1 festlegen. |
| Size | sizeof(NDIS_WWAN_REGISTRATION_STATE) |
Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.
uStatus
Ein Miniporttreiber muss dies auf WWAN_STATUS_SUCCESS für nicht angeforderte Ereignisse festlegen (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS ist auch für die erfolgreiche Ausführung der NDIS_WWAN_SET_REGISTER_STATE festgelegt.
Die folgende Tabelle zeigt die anderen möglichen Fehler status Codes.
| Wert | Bedeutung |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | Für das Gerät ist eine PIN-Werteingabe erforderlich. |
| WWAN_STATUS_FAILURE | Der Registrierungsstatus kann nicht abgerufen werden. |
| WWAN_STATUS_NOT_INITIALIZED | Der Vorgang ist fehlgeschlagen, da sich das Gerät gerade in der Initialisierung befindet. Wiederholen Sie den Vorgang, nachdem sich der Bereitzustand des Geräts in WwanReadyStateInitialized geändert hat. |
| WWAN_STATUS_BAD_SIM | Fehler beim Vorgang, weil eine fehlerhafte SIM-Karte erkannt wurde. |
| WWAN_STATUS_SIM_NOT_INSERTED | Der Vorgang ist fehlgeschlagen, da die SIM-Karte nicht vollständig in das Gerät eingefügt wurde. |
Miniport-Treiber können die folgenden Fehlercodes (zusätzlich zu den oben aufgeführten) nur zurückgeben, wenn ein PDP-Aktivierungssatzvorgang fehlschlägt.
| Wert | Bedeutung |
|---|---|
| WWAN_STATUS_FAILURE | Der Registrierungsstatus kann nicht festgelegt werden. Weitere Informationen werden in uNwError angegeben. Bei anderen Fehlercodes sollte uNwError auf 0 festgelegt werden. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | CDMA-basierte Geräte müssen diesen Fehlercode zurückgeben, wenn eine festgelegte Registrierungsanforderung für die manuelle Registrierung vorgesehen ist. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | Fehler bei der Dienstaktivierung. Das Abonnement ist abgelaufen. Das Gerät lässt das Festlegen des Registrierungsstatus nicht zu. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Der Anbieter ist für die Registrierung nicht sichtbar. Dies ist für die manuelle Registrierung vorgesehen. |
| WWAN_STATUS_INVALID_PARAMETERS | Wenn es sich bei der Anforderung um eine manuelle Registrierung bei einem verbotenen Anbieter handelt. |
| WWAN_STATUS_BUSY | Das Gerät ist ausgelastet und kann den Registrierungsmodus nicht ändern. Dieses Szenario kann auftreten, wenn das Gerät das Ändern des Registrierungsmodus nicht zulässt, wenn ein PDP-Kontext aktiviert wird. |
RegistrationState
Ein formatiertes WWAN_REGISTRATION_STATE-Objekt , das den Registrierungsstatus des MB-Geräts darstellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | ndiswwan.h (include Ndiswwan.h) |