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) |