NDIS_WWAN_CONTEXT_STATE-Struktur (ndiswwan.h)

Die NDIS_WWAN_CONTEXT_STATE-Struktur stellt den PDP-Kontextstatus (Packet Data Protocol) des MB-Geräts dar.

Syntax

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

Member

Header

Der Header mit Typ-, Revisions- und Größeninformationen zur NDIS_WWAN_CONTEXT_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 8 Miniporttreiber sollten dies auf NDIS_WWAN_CONTEXT_STATE_REVISION_2 festlegen. Windows 7-Miniporttreiber sollten dies auf NDIS_WWAN_CONTEXT_STATE_REVISION_1 festlegen.
Size	sizeof(NDIS_WWAN_CONTEXT_STATE)

 

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uStatus

Die status des Kontextaktivierungs- oder Deaktivierungsvorgangs. Die folgende Tabelle zeigt die möglichen Werte für diesen Member.

Wert	Bedeutung
WWAN_STATUS_SUCCESS	Die Aktivierung oder Deaktivierung des Kontexts war erfolgreich.
WWAN_STATUS_FAILURE	Fehler beim Vorgang. Miniport-Treiber können diesen Wert zurückgeben, wenn der Kontext bereits aktiviert wurde.
WWAN_STATUS_PIN_REQUIRED	Der Vorgang ist fehlgeschlagen, weil das Gerät eine PIN benötigt.
WWAN_STATUS_BAD_SIM	Der Vorgang ist fehlgeschlagen, weil eine ungültige SIM-Karte erkannt wurde.
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_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.

 

Miniport-Treiber können die folgenden Fehlercodes (zusätzlich zu den zuvor beschriebenen) nur bei einem fehlerhaften PDP-Aktivierungsvorgang zurückgeben.

Wert	Bedeutung
WWAN_STATUS_RADIO_POWER_OFF	Der Vorgang ist fehlgeschlagen, weil das Funkgerät derzeit ausgeschaltet ist. Dieser Fehlercode sollte nur als Reaktion auf eine OID_WWAN_CONNECT set-Anforderung zurückgegeben werden. Wenn der Funkzustand deaktiviert ist, sollte der Miniporttreiber auf OID_WWAN_CONNECT Abfrageanforderungen mit WWAN_STATUS_SUCCESS reagieren und den aktuellen Kontextstatus als WwanActivationStateDeactivated angeben.
WWAN_STATUS_SERVICE_NOT_ACTIVATED	Der Vorgang ist fehlgeschlagen, weil entweder das Abonnement abgelaufen ist oder das Gerät die PDP-Aktivierung nicht zulässt.
WWAN_STATUS_PROVIDER_NOT_VISIBLE	Der Vorgang ist fehlgeschlagen, weil der Dienstanbieter derzeit nicht sichtbar ist.
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS	Der Vorgang ist fehlgeschlagen, weil die maximale Anzahl aktivierter Kontexte erreicht wurde.
WWAN_STATUS_INVALID_ACCESS_STRING	Fehler beim Vorgang, weil die Zugriffszeichenfolge ungültig ist.
WWAN_STATUS_INVALID_USER_NAME_PWD	Der Vorgang ist fehlgeschlagen, weil der benutzername und/oder das kennwort ungültig sind. Der netzwerkspezifische Fehlercode ist möglicherweise in uNwError verfügbar.
WWAN_STATUS_PACKET_SVC_DETACHED	Fehler beim Vorgang, weil der Paketdienst getrennt wurde.
WWAN_STATUS_NOT_REGISTERED	Der Vorgang ist fehlgeschlagen, da sich das Gerät nicht im registrierten Zustand für die PDP-Aktivierung befindet.
WWAN_STATUS_VOICE_CALL_IN_PROGRESS	Der Vorgang ist fehlgeschlagen und kann nicht mit der PDP-Aktivierung fortgesetzt werden, da derzeit ein Sprachanruf ausgeführt wird. Dieser Wert gilt nur für Geräte, deren Sprachklasse auf WwanVoiceClassSeparateVoiceData festgelegt ist.
WWAN_STATUS_CONTEXT_NOT_ACTIVATED	Der Vorgang ist fehlgeschlagen, weil der durch ConnectionId identifizierte Kontext nicht der aktuell aktivierte Kontext ist.

ContextState

Ein formatiertes WWAN_CONTEXT_STATE-Objekt , das den PDP-Kontextstatus (Packet Data Protocol) des 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_CONTEXT_STATE