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;
Angehörige
uNwError
Ein netzwerkspezifischer Fehler im Falle eines Paketanfügungs- oder Paketablösungsfehlers. Weitere Informationen zu diesem Mitglied finden Sie im folgenden Abschnitt "Hinweise".
PacketServiceState
Der Paketdienststatus des Geräts.
AvailableDataClass
Eine Bitmap, die angibt, 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 dieses Element auf WWAN_DATA_CLASS_NONE festlegen, wenn das Gerät nicht in einem Netzwerk registriert ist oder wenn keine Datenklasse vorhanden ist oder wenn die unterstützte Datenklasse nicht verfügbar ist. Miniporttreiber müssen dieses Element mit einem gültigen Wert festlegen, wenn das Gerät in einem Netzwerk registriert ist.
CurrentDataClass
Ein einzelner Wert aus dem WwanDataClass Member in WWAN_DEVICE_CAPS, der angibt, welche Datenklasse derzeit vom Gerät verwendet wird.
Für alle Datendienste mit Ausnahme von HSPA sollten Miniporttreiber dieses Element auf einen einzelnen WWAN_DATA_CLASS_XXX Wert festlegen. Für HSPA-Datendienste sollten Miniporttreiber ein bitweises ODER von WWAN_DATA_CLASS_HSDPA und WWAN_DATA_CLASS_HSUPA angeben.
Miniport-Treiber müssen dieses Element mit einem gültigen Wert festlegen und die entsprechende Benachrichtigung senden, wenn das Gerät Dienste ändert, z. B. von 1xRTT zu 1xEV-DO.
Miniport-Treiber sollten diesen Member auf WWAN_DATA_CLASS_CUSTOM festlegen, wenn die Datenklasse nicht einer der vordefinierten Werte im WwanDataClass Member von WWAN_DEVICE_CAPSist.
FrequencyRange
Ein WWAN_5G_FREQUENCY_RANGE Wert, der die vom Gerät verwendeten Frequenzbereiche angibt. Dieses Element ist nur gültig, wenn CurrentDataClass- entweder WWAN_DATA_CLASS_5G_NSA oder WWAN_DATA_CLASS_SAist.
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 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.
Bemerkungen
Der aktuelle Paketanfügungsdienststatus wird in der Regel in der Benutzeroberfläche des Geräts widergespiegelt.
Der MB-Dienst kombiniert die Datenklassen, die in AvailableDataClass dargestellt werden, mit den unterstützten Datenklassen, die mit den Funktionen des Geräts gemeldet werden, um die Schnittmenge der verfügbaren Auswahlmöglichkeiten für den Benutzer anzuzeigen.
Wenn ein Gerät auch eine Datenklasse unterstützt, die nichts anderes als die vordefinierten Werte in der WwanDataClass Member von WWAN_DEVICE_CAPSist, sollte der Miniporttreiber das WWAN_DATA_CLASS_CUSTOM Flag zusammen mit der entsprechenden Bitmaske festlegen, die für die Datenklasse in diesem Element definiert ist.
Abfrage- und festlegen OID-Anforderungen sowie unerwünschte Statusereignisse verwenden das uNwError Member. Wenn kein netzwerkspezifischer Fehler vorliegt oder der netzwerkspezifische Fehler nicht bekannt ist, sollten Miniporttreiber dieses Element auf Null festlegen. Der Abschnitt "Statusanzeigestruktur" in MB Operational Semantics zeigt den Paketanfügungs- oder Pakettrennvorgang verursacht Codefehlerwerte, die in der 3GPP TS 24.008 Spezifikationdefiniert sind.
Die folgenden Punkte enthalten Richtlinien zum Zurückgeben von netzwerkspezifischem Fehler in verschiedenen Szenarien:
- Wenn der Paketanfügungsvorgang aufgrund eines netzwerkspezifischen Fehlers fehlschlägt, sollten Miniporttreiber den netzwerkspezifischen Fehler als Reaktion auf Abfrage Anforderungen zurückgeben. In diesem Fall sollten Miniporttreiber den uStatus- Member der NDIS_WWAN_PACKET_SERVICE_STATE-Struktur auf WWAN_STATUS_SUCCESS festlegen und das uNwError Mitglied auf den netzwerkspezifischen Fehlercode festlegen.
- Wenn ein festlegen, dass Anforderung fehlschlägt, sollten Miniporttreiber den netzwerkspezifischen Fehlercode zurückgeben. In diesem Fall sollten Miniporttreiber den uStatus- Member der NDIS_WWAN_PACKET_SERVICE_STATE-Struktur auf WWAN_STATUS_FAILURE festlegen und das uNwError Member auf den netzwerkspezifischen Fehlercode festlegen.
- Wenn sich der Status der Geräteregistrierung ändert, da das Netzwerkpaket das Gerät trennt, sollten nicht angeforderte Statusereignisse den netzwerkspezifischen Fehler enthalten. In diesem Fall sollte der 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.
Miniport-Treiber müssen den Ursachencode möglichst bald melden. Wenn das MB-Gerät beispielsweise beim Versuch, das Gerät bei einem Netzwerkanbieter zu registrieren, auf einen dieser Codes trifft, sollte der Miniporttreiber es zu diesem Zeitpunkt melden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | wwan.h (include Wwan.h) |