NDIS_WWAN_PACKET_SERVICE_STATE-Struktur (ndiswwan.h)

  • Artikel

Die NDIS_WWAN_PACKET_SERVICE_STATE-Struktur stellt den Anlagenstatus des Paketdiensts des MB-Geräts dar.

Syntax

typedef struct _NDIS_WWAN_PACKET_SERVICE_STATE {
  NDIS_OBJECT_HEADER  Header;
  WWAN_STATUS         uStatus;
  WWAN_PACKET_SERVICE PacketService;
} NDIS_WWAN_PACKET_SERVICE_STATE, *PNDIS_WWAN_PACKET_SERVICE_STATE;

Member

Header

Der Header mit Typ-, Revisions- und Größeninformationen zur NDIS_WWAN_PACKET_SERVICE_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 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 Windows 10, Version 1903 Miniporttreiber, die 5G unterstützen, legen dies auf NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2 fest. Miniport-Treiber, die 5G nicht unterstützen oder für frühere Versionen von Windows gelten, legen dies auf NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 fest.
Size sizeof(NDIS_WWAN_PACKET_SERVICE_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 wird auch für die erfolgreiche Ausführung von Set - und Abfrageanforderungen festgelegt.

WWAN_STATUS_SUCCESS sollte vom Miniporttreiber zurückgegeben werden, wenn der angeforderte Zustand und der aktuelle Zustand für eine festgelegte Anforderung identisch sind.

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 Paketdienststatus kann nicht abgerufen oder festgelegt werden.
WWAN_STATUS_NOT_INITIALIZED Der Vorgang ist fehlgeschlagen, weil das Gerät gerade initialisiert wird. Wiederholen Sie den Vorgang, nachdem sich der Bereitzustand des Geräts in WwanReadyStateInitialized geändert hat.
WWAN_STATUS_SIM_NOT_INSERTED Der Vorgang ist fehlgeschlagen, weil die SIM-Karte nicht vollständig in das Gerät eingefügt wurde.
WWAN_STATUS_BAD_SIM Der Vorgang ist fehlgeschlagen, weil eine ungültige SIM-Karte erkannt wurde.
 

Miniport-Treiber können die Fehlercodes (zusätzlich zu den oben aufgeführten) zurückgeben, die in der folgenden Tabelle für den Fall, dass eine Paketanfügungssatzanforderung fehlschlägt.

Wert Bedeutung
WWAN_STATUS_FAILURE Fehler beim Anfügen von Paketen oder Trennen von Paketen. Weitere Informationen werden unter uNwError-Element der WWAN_PACKET_SERVICE-Struktur festgelegt. Bei anderen WWAN_STATUS_XXX Fehlern sollte uNwError auf Null festgelegt werden.
WWAN_STATUS_SERVICE_NOT_ACTIVATED Das Gerät lässt das Festlegen des Paketdienststatus aufgrund eines Dienstaktivierungsfehlers oder eines abgelaufenen Abonnements nicht zu.
WWAN_STATUS_PROVIDER_NOT_VISIBLE Der Anbieter ist für Paketdienstvorgänge nicht sichtbar.
WWAN_STATUS_NOT_REGISTERED Das Gerät befindet sich nicht im registrierten Zustand, um einen Paketanfügungsvorgang auszuführen.
WWAN_STATUS_NO_DEVICE_SUPPORT Der SET-Paketdienst wird von diesem CDMA-basierten Gerät nicht unterstützt.
WWAN_STATUS_RADIO_POWER_OFF Paketanfügung nicht möglich, da das Funkgerät deaktiviert ist.
WWAN_STATUS_SIM_NOT_INSERTED Eine SIM-Karte wird nicht eingefügt.
WWAN_STATUS_BAD_SIM Es wird eine ungültige SIM-Karte erkannt.

PacketService

Ein formatiertes WWAN_PACKET_SERVICE-Objekt , das den Anlagenstatus des Paketdiensts 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_PACKET_SERVICE