Freigeben über


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