OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX is similar to OID_WWAN_DEVICE_CAPS but is a per-executor OID, unlike OID_WWAN_DEVICE_CAPS which is a per-device OID. This OID serves to indicate the hardware’s device/executor capability, including the capability on extended optional features such as LTE attach APN configuration.
Miniport drivers must process query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request before later sending an NDIS_STATUS_WWAN_DEVICE_CAPS_EX status notification containing an NDIS_WWAN_DEVICE_CAPS_EX structure, which in turn contains a WWAN_DEVICE_CAPS_EX structure, to provide information about the device's capability.
The following diagram illustrates a query request.
Set requests are not applicable.
Remarks
It is critical for the driver to report service extension capability as a whole including from the driver to the actual device. If a driver supports a service but it is not supported by the underlying hardware, then the service capabilities should be marked as FALSE.
OID_WWAN_DEVICE_CAPS_EX is also used to retrieve each executor’s capability. This OID is the same in structure as existing OID_WWAN_DEVICE_CAPS but with the addition of Executor ID. A miniport driver should report the highest OID version it supports.
Just as with OID_WWAN_DEVICE_CAPS, the parameters in this OID are not expected to change due to SIM cards but rather represent the modem’s RF capability of the selected executor. A physical hardware modem may have multiple executors and thus may have multiple interfaces that support OID_WWAN_DEVICE_CAPS_EX.
For possible future updates, if the OS’s requested version is newer than the device-supported version, the device should return the newest version of the OID structure it supports. If the OS’s requested version is older than the latest one supported by the device, then the device should return the version matching the OS’s specification. It is a requirement for IHVs to make sure all revisions of OID_WWAN_DEVICE_CAPS_EX are supported for backwards compatibility and legacy support.
Unlike other OIDs new to Windows 10 Version 1703 that are only required if the modem supports multi-SIM/multi-executors, this OID must be implemented for modems that would like to support any Microsoft-defined service extensions starting in Windows 10 Version 1703.
Versions of Windows prior to Windows 10 Version 1703 may still use the existing OID_WWAN_DEVICE_CAPS; their behavior with multi-executor capable modems is not a supported scenario. IHVs must define this behavior.
Windows 10, version 1903
Starting in Windows 10, version 1903, OID_WWAN_DEVICE_CAPS_EX has been upgraded to revision 2. A miniport driver must use revision 2 of this OID and the data structures it contains if the miniport driver supports 5G.
When the host queries capabilities using this OID, the miniport driver must check if the underlying hardware supports 5G cellular capabilities. If it does, the miniport driver sets the bitmask in the WwanDataClass field of the WWAN_DEVICE_CAPS_EX structure according to hardware capabilties.
Additionally, in the WwanOptionalServiceCaps field of the WWAN_DEVICE_CAPS_EX structure, a new optional service bit is defined that covers support of all new 5G-related extensions.
For more info about 5G data class support, see MB 5G data class support.
Requirements
Version |
Windows 10, version 1703 |
Header |
Ntddndis.h (include Ndis.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for