OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX ähnelt OID_WWAN_DEVICE_CAPS ist aber eine OID pro Executor, im Gegensatz zu OID_WWAN_DEVICE_CAPS die eine gerätespezifische OID ist. Diese OID dient dazu, die Geräte-/Executorfunktion der Hardware anzugeben, einschließlich der Funktion für erweiterte optionale Features wie die APN-Konfiguration mit LTE-Anschluss.
Miniport-Treiber müssen Abfrageanforderungen asynchron verarbeiten und zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben, bevor sie später eine NDIS_STATUS_WWAN_DEVICE_CAPS_EX status Benachrichtigung senden, die eine NDIS_WWAN_DEVICE_CAPS_EX-Struktur enthält, die wiederum eine WWAN_DEVICE_CAPS_EX-Struktur enthält, um Informationen zur Funktion des Geräts bereitzustellen.
Das folgende Diagramm veranschaulicht eine Abfrageanforderung.
Setanforderungen sind nicht zutreffend.
Bemerkungen
Es ist wichtig, dass der Treiber die Diensterweiterungsfunktion als Ganzes meldet, auch vom Treiber an das tatsächliche Gerät. Wenn ein Treiber einen Dienst unterstützt, aber von der zugrunde liegenden Hardware nicht unterstützt wird, sollten die Dienstfunktionen als FALSE markiert werden.
OID_WWAN_DEVICE_CAPS_EX wird auch verwendet, um die Funktionen jedes Executors abzurufen. Diese OID ist in der Struktur identisch mit vorhandenen OID_WWAN_DEVICE_CAPS jedoch mit dem Hinzufügen der Executor-ID. Ein Miniporttreiber sollte die höchste unterstützte OID-Version melden.
Genau wie bei OID_WWAN_DEVICE_CAPS wird erwartet, dass sich die Parameter in dieser OID nicht aufgrund von SIM-Karten ändern, sondern vielmehr die RF-Funktion des Modems des ausgewählten Executors darstellen. Ein physisches Hardwaremodem kann über mehrere Executors verfügen und daher über mehrere Schnittstellen verfügen, die OID_WWAN_DEVICE_CAPS_EX unterstützen.
Für mögliche zukünftige Updates sollte das Gerät die neueste Version der unterstützten OID-Struktur zurückgeben, wenn die vom Betriebssystem angeforderte Version neuer ist als die vom Gerät unterstützte Version. Wenn die vom Betriebssystem angeforderte Version älter ist als die neueste Version, die vom Gerät unterstützt wird, sollte das Gerät die Version zurückgeben, die der Spezifikation des Betriebssystems entspricht. IHVs müssen sicherstellen, dass alle Revisionen von OID_WWAN_DEVICE_CAPS_EX aus Gründen der Abwärtskompatibilität und legacy-Unterstützung unterstützt werden.
Im Gegensatz zu anderen neuen OIDs Windows 10 Version 1703, die nur erforderlich sind, wenn das Modem Multi-SIM/Multi-Executors unterstützt, muss diese OID für Modems implementiert werden, die von Microsoft definierte Diensterweiterungen ab Windows 10 Version 1703 unterstützen möchten.
Windows-Versionen vor Windows 10 Version 1703 verwenden möglicherweise weiterhin die vorhandene OID_WWAN_DEVICE_CAPS. Ihr Verhalten mit Multi-Executor-fähigen Modems wird nicht unterstützt. IHVs müssen dieses Verhalten definieren.
Windows 10, Version 1903
Ab Windows 10 Version 1903 wurde OID_WWAN_DEVICE_CAPS_EX auf Version 2 aktualisiert. Ein Miniporttreiber muss Revision 2 dieser OID und die darin enthaltenen Datenstrukturen verwenden, wenn der Miniporttreiber 5G unterstützt.
Wenn der Host Funktionen mit dieser OID abfragt, muss der Miniporttreiber überprüfen, ob die zugrunde liegende Hardware 5G-Mobilfunkfunktionen unterstützt. Wenn dies der Fall ist, legt der Miniporttreiber die Bitmaske im WwanDataClass-Feld der WWAN_DEVICE_CAPS_EX-Struktur entsprechend der Hardwarekapazität fest.
Darüber hinaus wird im Feld WwanOptionalServiceCaps der WWAN_DEVICE_CAPS_EX-Struktur ein neues optionales Dienstbit definiert, das die Unterstützung aller neuen 5G-bezogenen Erweiterungen abdeckt.
Weitere Informationen zur Unterstützung von 5G-Datenklassen finden Sie unter Mb 5G-Datenklassenunterstützung.
Requirements (Anforderungen)
Version |
Windows 10, Version 1703 |
Header |
Ntddndis.h (include Ndis.h) |