MB LTE-Anfügenvorgänge
LTE Attach APN-Konfiguration für MBIM-Modems
Traditionell wurde LTE Attach als Teil der Registrierung betrachtet, und Windows war nicht direkt an LTE-Attach-Verfahren beteiligt. Im Gegensatz zu typischen Leitungsswitch-Netzwerkregistrierungen ist LTE jedoch ein reines Paketswitch-Netzwerk und erfordert, dass ein standardmäßiger EPS-Bearer aktiviert ist, damit das Gerät die Registrierung im LTE-Netzwerk aufrechterhalten kann.
Um einen STANDARDMÄßIGen EPS-Bearer mit dem Netzwerk einzurichten, muss das Gerät während des LTE-Anfügeverfahrens eine PDP-Kontextaktivierung anfordern, was die APN-Spezifikation (Access Point Name) erfordert. Gemäß dem 3GPP-Standard gibt es vier Szenarien, in denen ein Gerät APN angeben kann, wenn es versucht, LTE anzufügen:
- Das Gerät gibt einen bestimmten LTE-Anschluss-APN an.
- Das Gerät gibt einen bestimmten LTE-Anschluss-APN an, aber das Netzwerk beschließt, das Gerät stattdessen während des Roamings an einen anderen APN anfügen zu lassen.
- Das Gerät gibt keinen LTE-Anschluss-APN an und ermöglicht es dem Netzwerk, dem Gerät einen zurückzuweisen.
- Das Gerät wurde aus einem 2G/3G-Netzwerk in LTE registriert und es gab bereits mindestens einen aktiven PDP-Kontext. Das Netzwerk verwendet es als LTE-Anschluss-APN.
Heute werden alle APN-Informationen mit LTE-Anschluss von IHVs und OEMs direkt im Modem für jeden Anbieter bereitgestellt, für den es konfiguriert ist. Es ist jedoch kein vollständig skalierbares Modell für IHVs und OEMs, um alle möglichen LTE-Anschluss-APN-Einstellungen für alle Betreiber auf der ganzen Welt zu haben. Ab Windows 10 Version 1703 werden neue Schnittstellen sowohl für NDIS-OIDs als auch für MBIM-proprietäre Microsoft-CIDs definiert, um die APN-Konfiguration mit LTE-Anfügung über das Betriebssystem zu unterstützen.
Ab Windows 10, Version 1703, kann der Benutzer den LTE-Anschluss-APN über die Einstellungen konfigurieren, wenn die zugrunde liegende Hardware die KONFIGURATION des LTE-Anschluss-APN über das Betriebssystem unterstützt. Hardware mit standardmäßigen APN-Konfigurationen mit LTE-Anschluss muss ihre Konfiguration auch vom Betriebssystem zur Verfügung stellen.
Dieses Feature wird unterstützt, indem zwei neue OIDs und CIDs hinzugefügt werden. Für IHV-Partner, die MBIM implementieren, muss nur die CID-Version unterstützt werden.
MB-Schnittstellenupdate für LTE-Anfügungsvorgänge
Zwei neue MBIM-CIDs wurden erstellt, um die KONFIGURATION der LTE-Anschluss-APN-Konfiguration und das Betriebssystem zum Abrufen der neuesten LTE-Attach-status des Geräts zu ermöglichen. Wenn IHV-Partner entscheiden, die Verwaltung der standardmäßigen LTE-Attach-APN-Verwaltung des Betriebssystems zu unterstützen, müssen beide Befehle unterstützt werden.
Dienstname = Grundlegende Verbindungserweiterungen
UUID = UUID_BASIC_CONNECT_EXTENSIONS
UUID-Wert = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | Befehlscode | Mindestversion des Betriebssystems |
|---|---|---|
| MBIM_CID_MS_LTE_ATTACH_CONFIG | 3 | Windows 10, Version 1703 |
| MBIM_CID_MS_LTE_ATTACH_STATUS | 4 | Windows 10, Version 1703 |
MBIM_CID_MS_LTE_ATTACH_CONFIG
Beschreibung
Lte-Anfügungskontexte können unterschiedlich sein, je nachdem, wie das Netzwerk während der Laufzeit mit dem Gerät interagiert. Für den Rest dieser Dokumentation wird der LTE-Anfügungskontext als der aktuelle PDP-Kontext bezeichnet, der für LTE-Anfügung verwendet wird, und der STANDARDkontext für LTE-Anfügungen wird als auf dem Gerät konfiguriert, mit dem LTE-Anfügen ausgeführt wird, wenn kein anderer aktivierter PDP-Kontext vorhanden ist. MBIM_CID_MS_LTE_ATTACH_CONFIG ermöglicht dem Betriebssystem das Abfragen und Festlegen des Standardmäßigen LTE-Anfügungskontexts des Anbieters der eingefügten SIM-Karte (MCC/MNC-Paar).
Obwohl der LTE-Anschluss-APN technisch als Kontext betrachtet werden könnte, unterscheidet er sich von allen anderen Kontexten, die im Modem gespeichert sind. Für alle anderen Kontexte erfolgt die Aktivierung nach der Registrierung und basierend auf verschiedenen Bedingungen kann das Betriebssystem entscheiden, welcher Kontext am besten für die Verbindung geeignet ist. Der LTE-Anfügungskontext wird jedoch im Rahmen der Geräteregistrierung im LTE-Netzwerk aktiviert. Das Betriebssystem kann keine netzwerkbezogenen status vor Abschluss der Registrierung abrufen. Aufgrund dieser Einschränkung muss das Betriebssystem in der Lage sein, den LTE-Anfügungskontext für alle verschiedenen Roamingbedingungen des Geräts zu konfigurieren, um sicherzustellen, dass sich das Gerät unabhängig von der Roaming-status im LTE-Netzwerk registrieren kann.
Die Aktivierung des LTE-Anfügenkontexts mit dem Netzwerk erfordert keine vom Betriebssystem explizite Verbindungsanforderung, da das Betriebssystem keine selbstinitiierte Kontextaktivierung des Modems kennt. Der Standardmäßige LTE-Anfügungskontext fällt in diese Kategorie. Wenn das Betriebssystem eine MBIM_CID_CONNECT Anforderung ausgibt, um einen PDP-Kontext zu aktivieren, und der angegebene PDP-Kontext mit allen folgenden Übereinstimmungen übereinstimmt, sollte das Modem die CID-Aktivierungsanforderung erfolgreich abschließen, ohne einen neuen Over-the-Air-Bearer im Netzwerk zu starten:
- Es ist ein aktivierter PDP-Kontext vorhanden, der vom Modem initiiert und nicht für das Betriebssystem zur Verfügung gestellt wird.
- Der PDP-Kontext entspricht dem angegebenen APN in der CID-Anforderung.
- Der IP-Typ des aktivierten PDP-Kontexts ist mit dem angeforderten IP-Typ in der CID kompatibel.
Dies ist wichtig, da das Betriebssystem nicht alle PDP-Kontexte kennt, die vom Modem initiiert wurden. Dadurch werden Netzwerkgeräusche und -last reduziert. Andernfalls sollte das Modem gemäß einer normalen Kontextaktivierungsanforderung einen neuen Over-the-Air-Bearer aufrufen, der den OS-APN-Spezifikationen entspricht. Die IP-Typkompatibilität wird hier angegeben:
| IP-Typ des aktivierten PDP-Kontexts innerhalb des Modems | Kompatibel mit angeforderten IP-Typen | Nicht kompatibel mit dem angeforderten IP-Typ |
|---|---|---|
| IPv4 | Standard; IPv4; IPv4v6; IPv4 und v6 | IPv6 |
| IPv6 | Standard; IPv6; IPv4v6; IPv4 und v6 | IPv4 |
| IPv4v6 | Standard; IPv4; IPv6; IPv4v6; IPv4 und v6 | Keine |
Hinweis
Das Modem sollte keinen zweiten PDP-Kontext aufrufen, wenn nur einer des IP-Typs über die Luft aktiviert ist. Wenn beispielsweise IPv4 aktiviert ist und der Host IPv4 und IPv6 anfordert, sollte das Modem die Aktivierungsanforderung abschließen, ohne einen IPv6-Bearer zu starten.
Wenn das Betriebssystem eine MBIM_CID_CONNECT Anforderung zum Deaktivieren eines PDP-Kontexts ausgibt, sollte das Modem Folgendes überprüfen:
- Ob das Gerät an LTE angeschlossen ist und der zu deaktivierende Kontext der einzige aktivierte PDP-Kontext ist, um die LTE-Registrierung aufrechtzuerhalten
- Gibt an, ob der zu deaktivierende Kontext auch intern vom Modem für Dienste verwendet wird, die nicht für das Betriebssystem verfügbar gemacht werden.
Wenn beides zutrifft, sollte das Modem die CID-Deaktivierungsanforderung abschließen, aber weiterhin den Over-the-Air-Bearer mit dem Netzwerk verwalten. Andernfalls sollte das Modem den Kontext gemäß den normalen Deaktivierungsanforderungen deaktivieren.
Alle vom Betriebssystem bereitgestellten Standard-LTE-Anfügungs-APN-Konfigurationen sind anbieterbezogen und entsprechen der eingefügten SIM-Karte-Heimanbieter-ID (MCC/MNC-Paar). Das Modem sollte nur bei Abfrage konfigurierten LTE-Anfügungskontext für die Anbieter-ID der aktuell eingefügten SIM bereitstellen. Das Modem sollte immer drei Standardmäßige LTE-Anfügungskontexte zurückgeben, die der Anbieter-ID der eingefügten SIM entsprechen, einer für jede Roamingbedingung (home/partner/non-partner).
Es wird erwartet, dass das Modem bei SIM-Swaps seinen Standardmäßigen LTE-Anfügungskontext löscht, bevor die Konfiguration für die nächste SIM-Karte angewendet wird. Wenn die neu eingefügte SIM-Karte keine Standardmäßige LTE-Anfügungskontextkonfiguration aufweist, sollte das Gerät leere NULL-Zeichenfolgen für den APN des LTE-Anfügungskontexts für alle Roamingbedingungen zurückgeben, wobei der Kontext aktiviert bleibt. Wenn der Kontext deaktiviert ist, wird erwartet, dass das Gerät nicht an LTE angeschlossen wird, da keine verwendbare Konfiguration für LTE-Anfügen vorhanden ist. Wenn der Benutzer zurück zu einer SIM-Karte wechselt, die zuvor auf dem Gerät konfiguriert wurde, sollte das Modem seine standardmäßige LTE-Anschlusskonfiguration für die SIM-Karte wiederherstellen. Es wird nicht erwartet, dass die Laufzeitkonfiguration über SIM-Swaps hinweg beibehalten wird. Es sollte jederzeit nur ein Standard-LTE-Anschluss-APN im Modem pro Roamingbedingung (Home/Partner/Nicht-Partner) vorhanden sein.
Das Betriebssystem legt immer alle drei Standardmäßigen LTE-Anfügungskontexte fest, wenn ein Set-Befehl ausgegeben wird, einen für jede Roamingbedingung. Wenn die vom Betriebssystem bereitgestellte Liste nicht genau drei enthält, sollte der Befehl Set abgelehnt werden. Wenn einer der bereitgestellten Standardmäßigen LTE-Anfügungskontexte vom Betriebssystem konfiguriert wird, bei dem die Roamingbedingung mit der aktuellen Registrierung status übereinstimmt, sollte sich das Modem vom Netzwerk trennen und das LTE-Anfügen mit dem neu angegebenen LTE-Anfügenkontext erneut ausführen. Andernfalls wird erwartet, dass das Gerät beim nächsten Mal den angegebenen Standardmäßigen LTE-Anfügungskontext verwendet, wenn die Roamingbedingungen übereinstimmen. Wenn der vom Gerät angegebene Standardkontext für LTE-Anfügungen nicht im LTE-Netzwerk registriert werden kann, sollte das Gerät nach Bedarf auf 3G/2G zurückgreifen. Wenn das Modem nicht zwischen Partner- und Nicht-Partnernetzwerken unterscheiden kann, sollte das Modem für alle Roamingszenarien den standardmäßigen LTE-Anfügungskontext verwenden, der nicht partnerseitig ist. Wenn das Betriebssystem den Standardmäßigen LTE-Anfügungskontext als IP-Typ = Standard konfiguriert, wird erwartet, dass das Modem dem LTE-Anfügungskontext den am besten geeigneten IP-Typ zuweist. Das Betriebssystem erwartet jedoch, dass das Modem weiterhin Partnerroamingbedingungen und den IP-Typ des LTE-Anfügungskontexts zurückgibt, der die Konfiguration genau widerspiegelt.
IHVs und OEMs können den LTE-Anfügungskontext als Standardkonfiguration im Modem vorkonfigurieren, aber diese Kontexte müssen als MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned getaggt werden.
Gemäß dem 3GPP-Standard kann der standardmäßige LTE-Anfügungskontext in zwei Kategorien unterteilt werden: UE-initiiert und netzwerkinitiiert. Wenn das Gerät mit einer leeren NULL-Zugriffszeichenfolge konfiguriert ist, wird davon ausgegangen, dass das Gerät keinen LTE-Anfügungskontext an das Netzwerk bereitstellt und wartet, bis das Netzwerk dem Gerät einen wieder zuweist. Wie in MBIM 1.0 vorgeschrieben, sollte das Modem den besten IP-Typ basierend auf seinem internen Algorithmus auswählen, wenn der IP-Typ des LTE-Anfügungskontexts standardmäßig konfiguriert ist.
Das folgende Diagramm veranschaulicht einen Beispielfluss der LTE-Anfügungskonfiguration.
Abfrage
MBIM_MS_LTE_ATTACH_CONFIG_INFO von abgeschlossenen Abfrage- und Set-Nachrichten im InformationBuffer zurückgegeben wird. Für Query ist der InformationBuffer NULL.
Set
Für Set enthält der InformationBuffer eine MBIM_MS_SET_LTE_ATTACH_CONFIG.
Nicht angeforderte Ereignisse
Der Event InformationBuffer enthält eine MBIM_MS_LTE_ATTACH_CONFIG_INFO-Struktur. In einigen Fällen wird der Standardmäßige LTE-Anfügungskontext vom Netzwerk entweder over-the-Air (OTA) oder vom Kurznachrichtendienst (SMS) aktualisiert, der nicht über den MBIM_CID_MS_LTE_ATTACH_CONFIG-Befehl des Betriebssystems ausgeführt wird. Die Funktion muss standardmäßige LTE-Anfügungskontexte aktualisieren und MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned entsprechend taggen. Danach müssen Funktionen den Host über Updates benachrichtigen, die dieses Ereignis mit der aktualisierten Liste verwenden.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Get-Help | MBIM_SET_MS_LTE_ATTACH_CONFIG | Nicht zutreffend | Nicht zutreffend |
| Antwort | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO |
Datenstrukturen
Abfrage
Der InformationBuffer muss NULL und InformationBufferLength null sein.
Set
Die folgende MBIM_MS_SET_LTE_ATTACH_CONFIG Struktur ist im InformationBuffer zu verwenden. Der Befehl Set ist nur gültig, wenn die Liste eine Elementanzahl von drei enthält, eines für jede Roamingbedingung (home/partner/non-partner).
| Offset | Size | Feld | Typ | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Vorgang | MBIM_MS_LTE_CONTEXT_OPERATIONS | Gibt den Typ des Vorgangs an, für den der Befehl Set verwendet wird. Wenn sie auf MbimMsLteAttachContextOperationRestoreFactory festgelegt ist, sollten alle anderen Felder ignoriert werden. Vom Betriebssystem erstellte oder geänderte STANDARD-LTE-Anfügungskontexte sollten entfernt werden, und die standardmäßigen vorkonfigurierten standardmäßigen LTE-Anfügungskontexte sollten geladen werden. Wenn das Modem nicht über eine Standardkonfiguration verfügt, sollten alle Standardmäßigen LTE-Anfügekontexte für Roamingbedingungen auf eine leere APN-Zeichenfolge und den IP-Typ = Standard festgelegt werden. |
| 4 | 4 | ElementCount (EC) | UINT32 | Anzahl der MBIM_MS_LTE_ATTACH_CONTEXT Strukturen, die im DataBuffer folgen. Diese Komponente ist derzeit auf drei festgelegt, eine für jede Roamingbedingung (home/partner/non-partner). |
| 8 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | Das erste Element des Paares ist ein 4-Byte-Offset, der vom Anfang (Offset 0) dieser MBIM_MS_LTE_ATTACH_CONFIG_INFO-Struktur zu einer MBIM_MS_LTE_ATTACH_CONTEXT-Struktur berechnet wird (weitere Informationen finden Sie in der MBIM_MS_LTE_ATTACH_CONTEXT Tabelle). Das zweite Element des Paares ist eine Größe von 4 Byte eines Zeigers auf die entsprechende MBIM_MS_LTE_ATTACH_CONTEXT-Struktur. |
| 8 + (8 * EG) | DataBuffer | DATABUFFER | Array von MBIM_MS_LTE_ATTACH_CONTEXT Strukturen. |
Die folgenden Strukturen werden in der vorherigen Tabelle verwendet.
MBIM_MS_LTE_ATTACH_CONTEXT_OPERATIONS beschreibt die Arten von Vorgängen, die im Befehl Set verwendet werden können.
| Typ | Wert | BESCHREIBUNG |
|---|---|---|
| MbimMsLteAttachContextOperationDefault | 0 | Standardvorgang zum Überschreiben vorhandener LTE-Standardanfügungskontexte im Modem. Das Betriebssystem ersetzt immer alle drei Standardmäßigen LTE-Anfügungskontexte für Roamingbedingungen. |
| MbimMsLteAttachContextOperationRestoreFactory | 1 | Stellen Sie den standardmäßigen LTE-Anfügungskontext für die Anbieter-ID der derzeit eingefügten SIM wieder her. Alle standardmäßigen LTE-Anfügungskontexte, die vom Betriebssystem ersetzt oder erstellt werden, sollten entfernt und ersetzt werden. Wenn für die aktuell eingefügte SIM-Anbieter-ID mit einer oder mehreren Roamingbedingungen kein standardmäßig vorkonfigurierter STANDARD-LTE-Anfügungskontext vorhanden ist, sollte der Standard-LTE-Anfügungskontext eine leere APN-Zeichenfolge und den IP-Typ = Standard zurückgeben. |
MBIM_MS_LTE_ATTACH_CONTEXT gibt den Kontext an, der für die LTE-Anfügungskonfiguration verwendet werden soll.
| Offset | Size | Feld | Typ | BESCHREIBUNG |
|---|---|---|---|---|
| 0 | 4 | IPType | MBIM_CONTEXT_IP_TYPE | Weitere Informationen finden Sie in der Tabelle MBIM_CONTEXT_IP_TYPE. |
| 4 | 4 | Roaming | MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL | Gibt an, welche Roamingbedingung für diesen standardmäßigen LTE-Anfügungskontext gilt. Weitere Informationen finden Sie in der Tabelle MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL. |
| 8 | 4 | Quelle | MBIM_MS_CONTEXT_SOURCE | Gibt die Erstellungsquelle des Kontexts an. Weitere Informationen finden Sie in der tabelle MBIM_MS_CONTEXT_SOURCE. |
| 12 | 4 | AccessStringOffset | OFFSET | Offset im Datenpuffer auf eine Zeichenfolge, AccessString, für den Zugriff auf das Netzwerk. Bei GSM-basierten Netzwerken wäre dies eine APN-Zeichenfolge (Access Point Name), z. B. "data.thephone-company.com". Die Größe der Zeichenfolge sollte 100 Zeichen nicht überschreiten. Wenn accessString leer ist, erwartet das Gerät, dass das Netzwerk dem Gerät eine Zugriffszeichenfolge zurückweist. Der IP-Typ muss in diesem Fall noch angegeben werden. |
| 16 | 4 | AccessStringSize | SIZE(0..200) | Für AccessString verwendete Größe. Dieser Wert sollte 0 sein, wenn das Gerät erwartet, dass das Netzwerk dem Gerät für lte attach eine Zugriffszeichenfolge zurückweist. |
| 20 | 4 | UserNameOffset | OFFSET | Offset in Bytes, berechnet vom Anfang dieser Struktur, zu einer Zeichenfolge, UserName, die den zu authentifizierden Benutzernamen darstellt. Dieser Member kann NULL sein. |
| 24 | 4 | UserNameSize | SIZE(0..510) | Für UserName verwendete Größe. |
| 28 | 4 | PasswordOffset | OFFSET | Offset in Bytes, berechnet vom Anfang dieser Struktur, zu einer Zeichenfolge, Password, die das Kennwort des Benutzernamens darstellt. Dieser Member kann NULL sein. |
| 32 | 4 | PasswordSize | SIZE(0..510) | Für Kennwort verwendete Größe. |
| 36 | 4 | Komprimierung | MBIM_COMPRESSION | Gibt die Komprimierung an, die in der Datenverbindung für Header und Daten verwendet werden soll. Dieser Member gilt nur für GSM-basierte Geräte. Der Host legt dieses Element für CDMA-basierte Geräte auf MBIMCompressionNone fest. Weitere Informationen finden Sie in der Tabelle MBIM_COMPRESSION. |
| 40 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Authentifizierungstyp, der für die PDP-Aktivierung verwendet werden soll. Weitere Informationen finden Sie in der Tabelle MBIM_AUTH_PROTOCOL. |
| 44 | DataBuffer | DATABUFFER | Der Datenpuffer, der AccessString, UserName und Password enthält. |
MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL gibt an, welche Roamingbedingung für diesen Standardmäßigen LTE-Anfügungskontext gilt.
| Typ | Wert | Beschreibung |
|---|---|---|
| MbimMsLteAttachContextRoamingControlHome | 0 | Gibt an, ob der Standardmäßige LTE-Anfügungskontext im Heimnetzwerk verwendet werden darf oder nicht. |
| MbimMsLteAttachContextRoamingControlPartner | 1 | Gibt an, ob der Kontext in Partnerroamingnetzwerken verwendet werden darf oder nicht. |
| MbimMsLteAttachContextRoamingControlNonPartner | 2 | Gibt an, ob der Kontext in Roamingnetzwerken ohne Partner verwendet werden darf. |
MBIM_MS_CONTEXT_SOURCE gibt die Erstellungsquelle des Kontexts an.
| Typ | Wert | Beschreibung |
|---|---|---|
| MbimMsContextSourceAdmin | 0 | Der Kontext wurde von einem ENTERPRISE-IT-Administrator aus dem Betriebssystem erstellt. |
| MbimMsContextSourceUser | 1 | Der Kontext wurde vom Benutzer über die Betriebssystemeinstellungen erstellt. |
| MbimMsContextSourceOperator | 2 | Der Kontext wurde vom Operator über OMA-DM oder andere Kanäle erstellt. |
| MbimMsContextSourceModem | 3 | Der Kontext wurde vom IHV oder OEM erstellt. |
| MbimMsContextSourceDevice | 4 | Der Kontext wurde von der Betriebssystem-APN-Datenbank erstellt. |
Antwort
Die folgende MBIM_MS_LTE_ATTACH_CONFIG_INFO Struktur wird im InformationBuffer verwendet.
| Offset | Size | Feld | Typ | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | ElementCount (EC) | UINT32 | Anzahl der MBIM_MS_LTE_ATTACH_CONTEXT Strukturen, die im DataBuffer folgen. Diese Komponente ist derzeit auf drei festgelegt, eine für jede Roamingbedingung (Home/Partner/Nicht-Partner). |
| 4 | 8 * EG | MsLteAttachContextRefList | OL_PAIR_LIST | Das erste Element des Paars ist ein 4-Byte-Offset, der vom Anfang (Offset 0) dieser MBIM_MS_LTE_ATTACH_CONFIG_INFO-Struktur bis zu einer MBIM_MS_LTE_ATTACH_CONTEXT-Struktur berechnet wird (weitere Informationen finden Sie in der tabelle MBIM_MS_LTE_ATTACH_CONTEXT). Das zweite Element des Paars ist eine 4-Byte-Größe eines Zeigers auf die entsprechende MBIM_MS_LTE_ATTACH_CONTEXT-Struktur. |
| 4 + (8 * EG) | DataBuffer | DATABUFFER | Array von MBIM_MS_LTE_ATTACH_CONTEXT Strukturen. |
Benachrichtigung
Weitere Informationen finden Sie in der Tabelle MBIM_MS_LTE_ATTACH_CONFIG_INFO.
Statuscodes
Für Abfrage- und Setvorgänge:
| Statuscode | BESCHREIBUNG |
|---|---|
| MBIM_STATUS_READ_FAILURE | Der Vorgang ist fehlgeschlagen, weil das Gerät bereitgestellte Kontexte nicht abrufen konnte. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Fehler beim Vorgang, da das Gerät den Vorgang nicht unterstützt. |
Nur für Set-Vorgänge:
| Statuscode | BESCHREIBUNG |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | Der Vorgang ist aufgrund ungültiger Parameter fehlgeschlagen. |
| MBIM_STATUS_WRITE_FAILURE | Fehler beim Vorgang, weil die Updateanforderung nicht erfolgreich war. |
MBIM_CID_MS_LTE_ATTACH_STATUS
Beschreibung
Pro 3GPP-Anforderung kann ein Gerät zwar den standardmäßigen LTE-Anfügungskontext angeben, der beim Anfügen von LTE an das Netzwerk ohne aktivierten PDP-Kontext verwendet werden soll, aber es kann Situationen geben, in denen das Gerät lte-an einen PDP-Kontext anfügt, der sich von dem auf dem Gerät konfigurierten Standardkontext für LTE-Anfügung unterscheidet. Die folgende Liste enthält alle möglichen Szenarien:
- Die UE gibt einen bestimmten LTE-Anschluss-APN an.
- Die UE gibt einen bestimmten LTE-Anschluss-APN an, aber das Netzwerk beschließt, das Gerät stattdessen während des Roamings an einen anderen APN anfügen zu lassen.
- Die UE gibt keinen LTE-Anschluss-APN an und ermöglicht es dem Netzwerk, dem Gerät einen zuzuweisen.
- Die UE registrierte sich von 2G/3G-Netz zu LTE und es gab bereits mindestens einen aktiven PDP-Kontext. Das Netzwerk verwendet es als LTE-Anschluss-APN.
Wenn das Standard-LTE des Geräts angefügt wird, sollte es eine Benachrichtigung über MBIM_CID_MS_LTE_ATTACH_STATUS an das Betriebssystem senden, um Details zum PDP-Kontext für die neueste LTE-Anlage anzugeben. Standardmäßiges LTE-Anfügen tritt auf, wenn eines der folgenden Szenarien erfüllt ist:
- Das Gerät wird zunächst an das LTE-Netzwerk angeschlossen.
- Das Gerät übergibt ohne zuvor aktivierten PDP-Kontext von 2G/3G an LTE.
Der von MBIM_CID_LTE_ATTACH_STATUS zurückgegebene LTE-Anfügungskontext kann einer der folgenden sein:
- Standardmäßiger LTE-Anfügungskontext, der im Modem gespeichert ist.
- Standardmäßiger LTE-Anfügungskontext, der aus dem Netzwerk zurückgewiesen wurde.
Während der Laufzeit sollte das Betriebssystem auch in der Lage sein, die zuletzt verwendeten Anfügungsinformationen für die Standard-LTE-Anfügung abzufragen. Es wird erwartet, dass das Modem den letzten bekannten Standardkontext für LTE-Anfügungen zurückgibt. Wenn das Gerät von LTE an das 2G/3G-Netzwerk übergeben wurde, wird erwartet, dass das Modem den Kontext zurückgibt, der für den vorherigen LTE-Anschluss verwendet wurde. Jedes Mal, wenn das Gerät die Registrierung aus dem Netzwerk aufgibt, wird erwartet, dass der APN leer wird.
Im folgenden Diagramm wird ein Beispiel für den Nachrichtenfluss für lte-anfügen status veranschaulicht.
Abfrage
MBIM_MS_LTE_ATTACH_STATUS wird von Vollständigen Abfragemeldungen im InformationBuffer zurückgegeben. Für Query ist der InformationBuffer NULL.
Set
Setvorgänge werden nicht unterstützt.
Nicht angeforderte Ereignisse
Der Event InformationBuffer enthält eine MBIM_MS_LTE_ATTACH_STATUS-Struktur.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Get-Help | Nicht zutreffend | Nicht zutreffend | Nicht zutreffend |
| Antwort | Nicht zutreffend | MBIM_MS_LTE_ATTACH_STATUS | MBIM_MS_LTE_ATTACH_STATUS |
Datenstrukturen
Abfrage
Der InformationBuffer muss NULL und InformationBufferLength null sein.
Set
Setvorgänge werden nicht unterstützt.
Antwort
Die folgende MBIM_MS_LTE_ATTACH_STATUS Struktur soll im InformationBuffer verwendet werden.
| Offset | Size | Feld | Typ | BESCHREIBUNG |
|---|---|---|---|---|
| 0 | 4 | LteAttachState | MBIM_MS_LTE_ATTACH_STATE | Gibt an, ob das Gerät derzeit an ein LTE-Netzwerk angeschlossen ist oder nicht. Weitere Informationen finden Sie in der Tabelle MBIM_MS_LTE_ATTACH_STATE. |
| 4 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | Weitere Informationen finden Sie in der Tabelle MBIM_CONTEXT_IP_TYPE. |
| 8 | 4 | AccessStringOffset | OFFSET | Offset im Datenpuffer auf eine Zeichenfolge, AccessString, für den Zugriff auf das Netzwerk. Bei GSM-basierten Netzwerken wäre dies eine APN-Zeichenfolge (Access Point Name), z. B. "data.thephone-company.com". Bei CDMA-basierten Netzwerken kann dies eine spezielle Vorwahlnummer wie "#777" oder ein Network Access Identifier (NAI) wie "foo@thephone-company.com" sein. Dieser Member kann NULL sein, um anzufordern, dass das Netzwerk den Standard-APN zuweisen soll. Hinweis: Nicht alle Netzwerke unterstützen diese NULL-APN-Konvention. Daher ist ein Verbindungsfehler, der durch einen ungültigen APN verursacht wird, ein mögliches Ergebnis. Die Größe der Zeichenfolge sollte 100 Zeichen nicht überschreiten. |
| 12 | 4 | AccessStringSize | SIZE(0..200) | Größe in Bytes, die für AccessString verwendet werden. |
| 16 | 4 | UserNameOffset | OFFSET | Offset in Bytes, der vom Anfang dieser Struktur berechnet wird, in eine Zeichenfolge, UserName, die den zu authentifizierden Benutzernamen darstellt. Dieses Element kann NULL sein. |
| 20 | 4 | UserNameSize | SIZE(0..510) | Größe in Bytes, die für UserName verwendet werden. |
| 24 | 4 | PasswordOffset | OFFSET | Offset in Bytes, berechnet vom Anfang dieser Struktur, zu einer Zeichenfolge, Password, die das Kennwort des Benutzernamens darstellt. Dieses Element kann NULL sein. |
| 28 | 4 | PasswordSize | SIZE(0..510) | Größe in Bytes, die für Kennwort verwendet werden. |
| 32 | 4 | Komprimierung | MBIM_COMPRESSION | Gibt die Komprimierung an, die in der Datenverbindung für Header und Daten verwendet werden soll. Dieses Mitglied gilt nur für GSM-basierte Geräte. Der Host legt dieses Element für CDMA-basierte Geräte auf MBIMCompressionNone fest. Weitere Informationen finden Sie in der Tabelle MBIM_COMPRESSION. |
| 36 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Authentifizierungstyp, der für die PDP-Aktivierung verwendet werden soll. Weitere Informationen finden Sie in der Tabelle MBIM_AUTH_PROTOCOL. |
| 40 | 4 | DataBuffer | DATABUFFER |
Die folgende Datenstruktur wird in der vorherigen Tabelle verwendet.
MBIM_MS_LTE_ATTACH_STATE gibt an, ob das Gerät derzeit an ein LTE-Netzwerk angeschlossen ist oder nicht.
| Typ | Wert | Beschreibung |
|---|---|---|
| MbimMsLteAttachStateDetached | 0 | Gibt an, dass das Gerät nicht an das LTE-Netzwerk angeschlossen ist. |
| MbimMsLteAttachStateAttached | 1 | Gibt an, dass das Gerät an das LTE-Netzwerk angeschlossen ist. |
Benachrichtigung
Weitere Informationen finden Sie in der Tabelle MBIM_MS_LTE_ATTACH_STATUS.
Statuscodes
Für Abfrage- und Setvorgänge:
| Statuscode | BESCHREIBUNG |
|---|---|
| MBIM_STATUS_READ_FAILURE | Der Vorgang ist fehlgeschlagen, weil das Gerät bereitgestellte Kontexte nicht abrufen konnte. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Fehler beim Vorgang, da das Gerät den Vorgang nicht unterstützt. |
HlK-Tests (Hardware Lab Kit)
Weitere Informationen finden Sie unter Schritte zum Installieren von HLK.
Stellen Sie in HLK Studio eine Verbindung mit dem Mobilfunkmodemtreiber des Geräts her, und führen Sie den Test aus: Win6_4.MB. GSM. Data.TestLteAttach.
Alternativ können Sie die TestLteAttach HLK-Testlist von netsh-mbn und netsh-mbn-test-installation ausführen.
netsh mbn test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
Diese Datei mit den HLK-Testergebnissen sollte in dem Verzeichnis generiert werden, in dem der Befehl "netsh mbn test" ausgeführt wurde: TestLteAttach.htm.
Manuelle Tests
- Anforderung: Eine Sim-Karte mit der richtigen APN-Einstellung und einer weiteren APN-Information für die manuelle Verwendung.
- Öffnen Sie Settings-Network> & Internet –> Mobilfunk
- Klicken Sie auf Erweiterte Optionen.
Verwenden von Mobilfunkeinstellungen:
- Es sollte mindestens ein Apn vorhanden sein, der die Einstellung aus den SIM-Informationen ist. Sie können die detaillierten Informationen des APN abrufen, indem Sie auf den APN klicken und auf die Schaltfläche "Ansicht" klicken.
Verwenden von manuellen Einstellungen:
- Befolgen Sie den Abschnitt "APN hinzufügen" unter Mobilfunkeinstellungen , um den APN manuell festzulegen.
- Fügen Sie den APN an, und überprüfen Sie die angefügte status.
Leitfaden zur Problembehandlung bei MB-LTE-Anfügungen
- Abrufen aller Anfügen von APN-Profilen unter %ProgramData%\Microsoft\WwanSvc\DMProfiles
- Verstehen, welches bestimmte Profil basierend auf erstellungstypprioritäten angewendet wird
- Untersuchen Sie die Protokolle, um zu überprüfen, warum der LTE Attach-APN falsch konfiguriert wurde.
- Sammeln und Decodieren der Protokolle mithilfe der Anweisungen unter Sammeln von Protokollen
- Öffnen Sie die .txt-Datei, die im TextAnalysisTool generiert wurde.
- Laden des LTE-Anfügenfilters
Beispielprotokoll für LTE Attach
10409 [0]0370.0434::2020-03-06 01:16:13.118424000 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14137 [0]0370.0684::2020-03-06 01:16:13.146883200 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14362 [0]0370.0684::2020-03-06 01:16:13.149255900 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14476 [1]0370.0434::2020-03-06 01:16:13.149677900 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14503 [0]0370.0684::2020-03-06 01:16:13.151412000 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14962 [0]0370.0684::2020-03-06 01:16:13.156860700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: WwanPmGetLteAttachProfileInEffect() didn't find anything, using Network Assigned.
14963 [0]0370.0684::2020-03-06 01:16:13.156862600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: LTEAttachConfig has same config as modem has, skip