NDIS_WWAN_REGISTRATION_STATE-Struktur (ndiswwan.h)

  • Artikel

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)

Weitere Informationen

NDIS_OBJECT_HEADER

WWAN_REGISTRATION_STATE