WWAN_PACKET_SERVICE-Struktur (wwan.h)
Die WWAN_PACKET_SERVICE-Struktur stellt den Paketdienstanlagenstatus des MB-Geräts dar.
Syntax
typedef struct _WWAN_PACKET_SERVICE {
ULONG uNwError;
WWAN_PACKET_SERVICE_STATE PacketServiceState;
ULONG AvailableDataClass;
ULONG CurrentDataClass;
WWAN_5G_FREQUENCY_RANGE FrequencyRange;
ULONG CurrentDataSubClass;
WWAN_SINGLE_TAI CurrentTai;
ULONG Rel3GppVer;
} WWAN_PACKET_SERVICE, *PWWAN_PACKET_SERVICE;
Member
uNwError
Ein netzwerkspezifischer Fehler, wenn ein Paketanfügungs- oder Paketablösungsfehler auftritt. Weitere Informationen zu diesem Member finden Sie im folgenden Abschnitt "Hinweise".
PacketServiceState
Der Paketdienststatus des Geräts.
AvailableDataClass
Eine Bitmap, die darstellt, welche Datenklassen für das Gerät im aktuellen Netzwerk verfügbar sind. Eine detaillierte Liste der Werte finden Sie im WwanDataClass-Member von WWAN_DEVICE_CAPS.
Miniport-Treiber müssen diesen Member auf WWAN_DATA_CLASS_NONE festlegen, wenn das Gerät nicht in einem Netzwerk registriert ist, wenn keine Datenklasse vorhanden ist oder wenn die unterstützte Datenklasse nicht verfügbar ist. Miniporttreiber müssen diesen Member mit einem gültigen Wert festlegen, wenn das Gerät bei einem Netzwerk registriert ist.
CurrentDataClass
Ein einzelner Wert aus dem WwanDataClass-Member in WWAN_DEVICE_CAPS , der darstellt, welche Datenklasse derzeit vom Gerät verwendet wird.
Für alle Datendienste mit Ausnahme von HSPA sollten Miniporttreiber diesen Member auf einen einzelnen WWAN_DATA_CLASS_XXX-Wert festlegen. Für HSPA-Datendienste sollten Miniporttreiber einen bitweisen OR mit WWAN_DATA_CLASS_HSDPA und WWAN_DATA_CLASS_HSUPA angeben.
Miniport-Treiber müssen diesen Member mit einem gültigen Wert festlegen und die entsprechende Benachrichtigung senden, wenn das Gerät dienste ändert, z. B. von 1xRTT in 1xEV-DO.
Miniporttreiber sollten diesen Member auf WWAN_DATA_CLASS_CUSTOM festlegen, wenn die Datenklasse nicht einer der vordefinierten Werte im WwanDataClass-Member von WWAN_DEVICE_CAPS ist.
FrequencyRange
Ein WWAN_5G_FREQUENCY_RANGE Wert, der die Frequenzbereiche angibt, die das Gerät verwendet. Dieser Member ist nur gültig, wenn CurrentDataClass entweder WWAN_DATA_CLASS_5G_NSA oder WWAN_DATA_CLASS_SA ist.
CurrentDataSubClass
Dieses Feld wird nur für NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3 verwendet.
CurrentTai
Eine WWAN_SINGLE_TAI-Struktur , die die aktuelle einzelne Tracking Area Identity (TAI) darstellt. Dieses Feld wird nur für NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3 verwendet.
Rel3GppVer
0xFFFFFFFF wird verwendet, wenn unbekannt. Unbekannt bedeutet, dass entweder MBIM_TLV_TYPE_3GPP_REL_VERSION nicht in MBIM_PACKET_SERVICE_INFO_V3 enthalten ist, das Gerät direkt 0xFFFFFFFF zurückgibt oder das Gerät MBIM 3.0 oder älter verwendet.
Hinweise
Der aktuelle Zustand des Paketanfügungsdiensts wird in der Regel auf der Benutzeroberfläche des Geräts widergespiegelt.
Der MB-Dienst kombiniert die Datenklassen, die in AvailableDataClass dargestellt sind, mit den unterstützten Datenklassen, die mit den Funktionen des Geräts gemeldet werden, um dem Benutzer die Schnittmenge der verfügbaren Optionen anzuzeigen.
Wenn ein Gerät auch eine Datenklasse unterstützt, die nichts anderes als die vordefinierten Werte im WwanDataClass-Member von WWAN_DEVICE_CAPS ist, sollte der Miniporttreiber das WWAN_DATA_CLASS_CUSTOM-Flag zusammen mit der entsprechenden Bitmaske festlegen, die für die Datenklasse in diesem Member definiert ist.
Abfragen und Festlegen von OID-Anforderungen sowie unerwünschten status-Ereignissen verwenden den uNwError-Member. Wenn kein netzwerkspezifischer Fehler vorliegt oder der netzwerkspezifische Fehler nicht bekannt ist, sollten Miniporttreiber diesen Member auf 0 festlegen. Der Abschnitt "Statusanzeigestruktur" in MB Operational Semantics zeigt die Fehlerwerte für Paketanfügungen oder Pakettrennen, die in der 3GPP TS 24.008-Spezifikation definiert sind.
Die folgenden Punkte enthalten Richtlinien zum Zurückgeben netzwerkspezifischer Fehler in verschiedenen Szenarien:
- Wenn der Paketanfügungsvorgang aufgrund eines netzwerkspezifischen Fehlers fehlschlägt, sollten Miniporttreiber den netzwerkspezifischen Fehler als Reaktion auf Abfrageanforderungen zurückgeben. In diesem Fall sollten Miniporttreiber den uStatus-Member der NDIS_WWAN_PACKET_SERVICE_STATE-Struktur auf WWAN_STATUS_SUCCESS festlegen und den uNwError-Member auf den netzwerkspezifischen Fehlercode festlegen.
- Wenn bei einer Setanforderung ein Fehler auftritt, sollten Miniporttreiber den netzwerkspezifischen Fehlercode zurückgeben. In diesem Fall sollten Miniporttreiber das uStatus-Element der NDIS_WWAN_PACKET_SERVICE_STATE-Struktur auf WWAN_STATUS_FAILURE festlegen und den uNwError-Member auf den netzwerkspezifischen Fehlercode festlegen.
- Wenn sich der Geräteregistrierungsstatus ändert, weil das Netzwerkpaket das Gerät trennt, sollten nicht angeforderte status Ereignisse den netzwerkspezifischen Fehler enthalten. In diesem Fall sollte der Miniporttreiber das uStatus-Element der NDIS_WWAN_PACKET_SERVICE_STATE-Struktur auf WWAN_STATUS_SUCCESS festlegen und den uNwError-Member auf den netzwerkspezifischen Fehlercode festlegen.
Miniporttreiber müssen den Ursachecode so früh wie möglich instance melden. Wenn das MB-Gerät beispielsweise beim Versuch, das Gerät bei einem Netzwerkanbieter zu registrieren, auf einen dieser Codes stößt, sollte der Miniporttreiber dies zu diesem Zeitpunkt melden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | wwan.h (include Wwan.h) |