WWAN_REGISTRATION_STATE Struktur (wwan.h)
Die WWAN_REGISTRATION_STATE-Struktur stellt den Registrierungsstatus des MB-Geräts dar.
Syntax
typedef struct _WWAN_REGISTRATION_STATE {
ULONG uNwError;
WWAN_REGISTER_STATE RegisterState;
WWAN_REGISTER_MODE RegisterMode;
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
WCHAR RoamingText[WWAN_ROAMTEXT_LEN];
DWORD WwanRegFlags;
WWAN_CELLULAR_CLASS CurrentCellularClass;
ULONG PreferredDataClasses;
} WWAN_REGISTRATION_STATE, *PWWAN_REGISTRATION_STATE;
Angehörige
uNwError
Ein netzwerkspezifischer Fehler im Falle eines Registrierungsfehlers. Weitere Informationen zu diesem Mitglied finden Sie im folgenden Abschnitt "Hinweise".
RegisterState
Der Registrierungsstatus des Geräts. Eine Liste der definierten Werte finden Sie unter WWAN_REGISTER_STATE.
Der wert WwanRegisterStatePartner gibt an, dass das Gerät auf einem bevorzugten Partnernetzwerkanbieter roamingt, während WwanRegisterStateRoaming Wert angibt, dass das Gerät einfach roamingt. Wenn die Partnercharakterisierung des Roamingzustands nicht verfügbar ist, sollte der Miniporttreiber WwanRegisterStateRoamingmelden.
RegisterMode
Der Registrierungsmodus des Geräts. Eine Liste der definierten Werte finden Sie unter WWAN_REGISTER_MODE.
ProviderId[WWAN_PROVIDERID_LEN]
Eine mit NULL beendete numerische Zeichenfolge (0-9), die die Identität des Netzwerkanbieters darstellt.
Bei GSM-basierten Netzwerken handelt es sich bei dieser Zeichenfolge um eine Verkettung einer dreistelligen Landeskennzahl (Mobile Country Code, MCC) und eines zwei- oder dreistelligen Mobilfunknetzcodes (MNC). GSM-basierte Netzbetreiber können mehr als einen MNC haben und daher mehr als eine ProviderId .
Bei CDMA-basierten Netzwerken ist diese Zeichenfolge eine fünfstellige System-ID (SID). Im Allgemeinen verfügt ein CDMA-basierter Netzbetreiber über mehr als eine SID. In der Regel verfügt ein Netzbetreiber über eine SID für jeden Markt, der in der Regel geografisch innerhalb einer Nation durch Vorschriften unterteilt wird, z. B. Metropolitan Statistical Areas (MSA) in den VEREINIGTEN Staaten von Amerika. Miniporttreiber von CDMA-basierten Geräten müssen WWAN_CDMA_DEFAULT_PROVIDER_ID angeben, wenn diese Informationen nicht verfügbar sind.
Bei der Verarbeitung einer Abfrage Anforderung und der Registrierungsstatus befindet sich im automatischen Registrierungsmodus, enthält dieses Mitglied die Anbieter-ID, der das Gerät derzeit zugeordnet ist (falls zutreffend). Wenn sich der Registrierungsstatus im manuellen Registrierungsmodus befindet, enthält dieses Mitglied die Anbieter-ID, bei der das Gerät zur Registrierung angefordert wird (auch wenn der Anbieter nicht verfügbar ist).
Bei der Verarbeitung eines Festlegens Anforderung und der Registrierungsstatus befindet sich im manuellen Modus, enthält dies die vom MB-Dienst für das Gerät ausgewählte Anbieter-ID, bei der sich das Gerät registrieren soll. Wenn sich der Registrierungsstatus im automatischen Registrierungsmodus befindet, wird dieser Parameter ignoriert.
CDMA 1xRTT-Anbieter müssen auf WWAN_CDMA_DEFAULT_PROVIDER_ID festgelegt werden, wenn die Anbieter-ID nicht verfügbar ist.
ProviderName[WWAN_PROVIDERNAME_LEN]
Eine MIT NULL beendete Zeichenfolge, die den Namen des Netzwerkanbieters darstellt. Dieses Element ist höchstens auf WWAN_PROVIDERNAME_LEN Zeichen beschränkt.
Bei GSM-basierten Netzwerken sollte der Miniporttreiber den Netzwerknamen kürzen, wenn die bevorzugte Darstellung der Länderinitialen und des Mobilfunknetzwerknamens (PPCI&N) länger als zwanzig Zeichen ist.
Dieses Element wird ignoriert, wenn der MB-Dienst die bevorzugte Anbieterliste festlegt.
Miniport-Treiber sollten eine NULL- Zeichenfolge für Geräte angeben, die diese Informationen nicht enthalten.
RoamingText[WWAN_ROAMTEXT_LEN]
Eine MIT NULL beendete Zeichenfolge, um den Benutzer darüber zu informieren, dass das Gerät roamingt. Dieses Element ist auf höchstens WWAN_ROAMTEXT_LEN Zeichen beschränkt.
Dieser Text sollte dem Benutzer zusätzliche Informationen bereitstellen, wenn der Registrierungsstatus entweder WwanRegisterStatePartner oder WwanRegisterStateRoamingist. Dieses Element ist optional.
WwanRegFlags
Registrierungskennzeichnungen.
| Wert | Bedeutung |
|---|---|
| WWAN_REG_FLAGS_NONE | Keine Registrierungskennzeichnungen. |
| WWAN_REG_FLAGS_NO_MANUAL_REG | Kein manueller Anfügen. |
| WWAN_REG_FLAGS_PS_AUTO_ATTACH | Gibt an, dass das MB-Gerät seinen eigenen Paketkontext verwaltet. Der MB-Dienst sendet kein Pakettrennzeichen an den Miniporttreiber, sondern kann eine Paketanfügung senden. |
CurrentCellularClass
Die aktuelle Mobilfunkklasse des registrierten Netzwerks. Für Netzwerke, die nur eine einzelne Mobilfunkklasse unterstützen, sollte dieses Mitglied auf diese Mobilfunkklasse festgelegt werden. Für multimodusfähige Netzwerke sendet der Miniporttreiber NDIS_STATUS_WWAN_REGISTER_STATE Benachrichtigungen an den MB-Dienst, wenn das Netzwerk seine Mobilfunkklasse ändert.
PreferredDataClasses
Eine Bitmaske, die die Datenzugriffstechnologien darstellt, die für eine Verbindung bevorzugt werden.
Bemerkungen
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 die Registrierungsursache Fehlerwerte an, die in der 3GPP TS 24.008 Specificationdefiniert sind.
Die folgenden Punkte enthalten Richtlinien zum Zurückgeben von netzwerkspezifischem Fehler in verschiedenen Szenarien:
- Wenn die Netzwerkregistrierung 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_REGISTRATION_STATE-Struktur auf WWAN_STATUS_SUCCESS festlegen und das uNwError Member 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_REGISTRATION_STATE Struktur auf WWAN_STATUS_FAILURE festlegen und das uNwError- Mitglied auf den netzwerkspezifischen Fehlercode festlegen.
- Wenn sich der Status der Geräteregistrierung ändert, da das Gerät vom Netzwerk aufgehoben wird (z. B. das Netzwerk wurde das Gerät aufgehoben, da das Abonnement des Geräts abgelaufen ist), sollten unerwünschte Statusereignisse den netzwerkspezifischen Fehler enthalten. In diesem Fall sollte der Miniporttreiber den uStatus Member der NDIS_WWAN_REGISTRATION_STATE Struktur auf WWAN_STATUS_SUCCESS festlegen und das uNwError Member auf den netzwerkspezifischen Fehlercode festlegen.
Miniport-Treiber können zusätzliche Fehlercodes gemäß der GSM-Standardsspezifikation von Paketanfügungsfehlercodes bereitstellen, die vom Netzwerk zurückgegeben werden. Miniporttreiber können z. B. die 3GPP-Spezifikation TS 24.008 Paketanfügungsfehlercodes, z. B. Fehlercode 12 (Standortbereich nicht zulässig), über den uNwError Member an den MB-Dienst übermitteln.
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.
Miniporttreiber, die mit einem Multimodusnetzwerk verbunden sind, sollten die Änderung der Mobilfunkklasse über eine NDIS_STATUS_WWAN_REGISTER_STATE-Benachrichtigung angeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Header- | wwan.h (include Wwan.h) |