NDIS_WWAN_PACKET_SERVICE_STATE-Struktur (ndiswwan.h)
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) |