OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX es similar a OID_WWAN_DEVICE_CAPS , pero es un OID por ejecutor, a diferencia de OID_WWAN_DEVICE_CAPS que es un OID por dispositivo. Este OID sirve para indicar la funcionalidad del dispositivo o ejecutor del hardware, incluida la funcionalidad en características opcionales extendidas, como la configuración de APN de conexión LTE.
Los controladores de miniport deben procesar las solicitudes de consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original antes de enviar más adelante una notificación de estado de NDIS_STATUS_WWAN_DEVICE_CAPS_EX que contiene una estructura de NDIS_WWAN_DEVICE_CAPS_EX , que a su vez contiene una estructura de WWAN_DEVICE_CAPS_EX , para proporcionar información sobre la funcionalidad del dispositivo.
En el diagrama siguiente se muestra una solicitud de consulta.
Las solicitudes establecidas no son aplicables.
Comentarios
Es fundamental que el controlador informe de la funcionalidad de extensión del servicio como un todo, incluido desde el controlador al dispositivo real. Si un controlador admite un servicio, pero no es compatible con el hardware subyacente, las funcionalidades de servicio deben marcarse como FALSE.
OID_WWAN_DEVICE_CAPS_EX también se usa para recuperar la funcionalidad de cada ejecutor. Este OID es el mismo en estructura que el OID_WWAN_DEVICE_CAPS existente, pero con la adición del identificador del ejecutor. Un controlador de minipuerto debe notificar la versión de OID más alta que admite.
Al igual que con OID_WWAN_DEVICE_CAPS, no se espera que los parámetros de este OID cambien debido a tarjetas SIM, sino que representen la funcionalidad RF del módem del ejecutor seleccionado. Un módem de hardware físico puede tener varios ejecutores y, por tanto, puede tener varias interfaces que admitan OID_WWAN_DEVICE_CAPS_EX.
Para futuras actualizaciones posibles, si la versión solicitada del sistema operativo es más reciente que la versión compatible con el dispositivo, el dispositivo debe devolver la versión más reciente de la estructura de OID que admite. Si la versión solicitada del sistema operativo es anterior a la más reciente compatible con el dispositivo, el dispositivo debe devolver la versión que coincida con la especificación del sistema operativo. Es un requisito para los IHD asegurarse de que todas las revisiones de OID_WWAN_DEVICE_CAPS_EX son compatibles con la compatibilidad con versiones anteriores y la compatibilidad heredada.
A diferencia de otros OID nuevos en Windows 10 versión 1703 que solo son necesarias si el módem admite multi-SIM/multiexecutores, este OID debe implementarse para módems que deseen admitir las extensiones de servicio definidas por Microsoft a partir de Windows 10 versión 1703.
Las versiones de Windows anteriores a Windows 10 versión 1703 todavía pueden usar el OID_WWAN_DEVICE_CAPS existente; su comportamiento con módems compatibles con varios ejecutores no es un escenario compatible. Los IHD deben definir este comportamiento.
Windows 10, versión 1903
A partir de Windows 10, versión 1903, OID_WWAN_DEVICE_CAPS_EX se ha actualizado a la revisión 2. Un controlador de minipuerto debe usar la revisión 2 de este OID y las estructuras de datos que contiene si el controlador de minipuerto admite 5G.
Cuando el host consulta las funcionalidades que usan este OID, el controlador de minipuerto debe comprobar si el hardware subyacente admite funcionalidades de telefonía móvil 5G. Si es así, el controlador de minipuerto establece la máscara de bits en el campo WwanDataClass de la estructura WWAN_DEVICE_CAPS_EX según las capabilidades de hardware.
Además, en el campo WwanOptionalServiceCaps de la estructura de WWAN_DEVICE_CAPS_EX , se define un nuevo bit de servicio opcional que cubre la compatibilidad de todas las nuevas extensiones relacionadas con 5G.
Para obtener más información sobre la compatibilidad con clases de datos 5G, consulta Compatibilidad con clases de datos mb 5G.
Requisitos
Versión |
Windows 10, versión 1703 |
Encabezado |
Ntddndis.h (include Ndis.h) |