OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX ähnelt OID_WWAN_DEVICE_CAPS, ist aber ein OID pro Executor, im Gegensatz zu OID_WWAN_DEVICE_CAPS, bei dem es sich um ein OID pro Gerät handelt. Dieses OID dient dazu, die Geräte-/Executorfunktion der Hardware anzugeben, einschließlich der Funktion für erweiterte optionale Features wie die LTE-Attach-APN-Konfiguration.
Miniport-Treiber müssen Abfrageanforderungen asynchron verarbeiten und zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben, bevor später eine NDIS_STATUS_WWAN_DEVICE_CAPS_EX Statusbenachrichtigung mit einer NDIS_WWAN_DEVICE_CAPS_EX Struktur gesendet wird, die wiederum eine WWAN_DEVICE_CAPS_EX Struktur enthält, um Informationen zur Funktion des Geräts bereitzustellen.
Das folgende Diagramm veranschaulicht eine Abfrageanforderung.
Festgelegte Anforderungen sind nicht anwendbar.
Bemerkungen
Es ist wichtig, dass der Treiber die Diensterweiterungsfunktion als Ganzes meldet, einschließlich des Treibers bis zum tatsächlichen Gerät. Wenn ein Treiber einen Dienst unterstützt, aber von der zugrunde liegenden Hardware nicht unterstützt wird, sollten die Dienstfunktionen als FALSCH gekennzeichnet werden.
OID_WWAN_DEVICE_CAPS_EX wird auch verwendet, um die Funktion jedes Executors abzurufen. Diese OID ist die gleiche Struktur wie vorhandene OID_WWAN_DEVICE_CAPS, aber mit dem Hinzufügen von Executor ID. Ein Miniporttreiber sollte die höchste unterstützte OID-Version melden.
Genau wie bei OID_WWAN_DEVICE_CAPSwerden die Parameter in diesem OID aufgrund von SIM-Karten nicht geändert, sondern stellen die RF-Funktion des Modems des ausgewählten Executors dar. Ein physisches Hardwaremodem verfügt möglicherweise über mehrere Executoren und verfügt daher über mehrere Schnittstellen, die OID_WWAN_DEVICE_CAPS_EX unterstützen.
Wenn die angeforderte Version des Betriebssystems für mögliche zukünftige Updates neuer als die gerätegestützte Version ist, sollte das Gerät die neueste Version der unterstützten OID-Struktur zurückgeben. Wenn die angeforderte Version des Betriebssystems älter als die neueste version ist, die vom Gerät unterstützt wird, sollte das Gerät die Version zurückgeben, die der Betriebssystemspezifikation entspricht. Es ist eine Anforderung für IHVs, sicherzustellen, dass alle Überarbeitungen von OID_WWAN_DEVICE_CAPS_EX für Abwärtskompatibilität und Legacyunterstützung unterstützt werden.
Im Gegensatz zu anderen OIDs, die neu in Windows 10 Version 1703 sind, die nur erforderlich sind, wenn das Modem Multi-SIM/Multi-Executors unterstützt, muss dieses OID für Modems implementiert werden, die alle von Microsoft definierten Diensterweiterungen ab Windows 10 Version 1703 unterstützen möchten.
Versionen von Windows vor Windows 10, Version 1703, können weiterhin die vorhandene OID_WWAN_DEVICE_CAPSverwenden; Ihr Verhalten mit Multi-Executor-fähigen Modems ist kein unterstütztes Szenario. 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 dieses OID und die darin enthaltenen Datenstrukturen verwenden, wenn der Miniporttreiber 5G unterstützt.
Wenn die Hostfunktionen mit diesem OID abfragen, 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 hardware capabilties fest.
Darüber hinaus wird im WwanOptionalServiceCaps Feld der WWAN_DEVICE_CAPS_EX-Struktur ein neues optionales Servicebit 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.
Anforderungen
Version |
Windows 10, Version 1703 |
Kopfball |
Ntddndis.h (include Ndis.h) |