OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX похож на OID_WWAN_DEVICE_CAPS, но является OID для каждого исполнителя, в отличие от OID_WWAN_DEVICE_CAPS который является OID для каждого устройства. Этот OID служит для указания возможности устройства или исполнителя оборудования, включая возможность расширенных дополнительных функций, таких как конфигурация подключения APN для LTE.
Драйверы минипорта должны обрабатывать запросы асинхронно, первоначально возвращая NDIS_STATUS_INDICATION_REQUIRED исходному запросу, прежде чем позже отправить уведомление о состоянии NDIS_STATUS_WWAN_DEVICE_CAPS_EX, содержащее структуру NDIS_WWAN_DEVICE_CAPS_EX, которая, в свою очередь, содержит структуру WWAN_DEVICE_CAPS_EX, для предоставления сведений о возможностях устройства.
На следующей схеме показан запрос запроса.
Установка запросов неприменимо.
Замечания
Важно, чтобы драйвер сообщал о возможностях расширения службы в целом, включая драйвер на фактическое устройство. Если драйвер поддерживает службу, но не поддерживается базовым оборудованием, то возможности службы должны быть помечены как FALSE.
OID_WWAN_DEVICE_CAPS_EX также используется для получения возможностей каждого исполнителя. Этот OID совпадает со структурой, что и существующие OID_WWAN_DEVICE_CAPS, но с добавлением идентификатора исполнителя. Минипорт-драйвер должен сообщить о самой высокой версии OID, поддерживающей ее.
Как и в случае с OID_WWAN_DEVICE_CAPS, параметры в этом OID не должны изменяться из-за SIM-карт, а скорее представляют возможности модема для выбранного исполнителя. Физический аппаратный модем может иметь несколько исполнителей, поэтому может иметь несколько интерфейсов, поддерживающих OID_WWAN_DEVICE_CAPS_EX.
Для возможных будущих обновлений, если запрошенная версия ОС является более новой, чем поддерживаемая устройством версия, устройство должно вернуть последнюю версию поддерживаемой структуры OID. Если запрошенная версия ОС старше последней, поддерживаемой устройством, устройство должно вернуть версию, соответствующую спецификации ОС. Это требование для IHV, чтобы убедиться, что все редакции OID_WWAN_DEVICE_CAPS_EX поддерживаются для обратной совместимости и устаревшей поддержки.
В отличие от других идентификаторов OID, новых для Windows 10 версии 1703, которые требуются только в том случае, если модем поддерживает мультисим-SIM/мульти-исполнителей, этот OID должен быть реализован для модемов, которые хотели бы поддерживать любые расширения службы, определенные корпорацией Майкрософт, начиная с Windows 10 версии 1703.
Версии Windows до Windows 10 версии 1703 по-прежнему могут использовать существующие OID_WWAN_DEVICE_CAPS; их поведение с несколькими исполнителями модемов не поддерживается. IHV должны определять это поведение.
Windows 10 версии 1903
Начиная с Windows 10 версии 1903, OID_WWAN_DEVICE_CAPS_EX обновлен до версии 2. Минипорт-драйвер должен использовать версию 2 этого OID и структуры данных, содержащиеся в нем, если драйвер минипорта поддерживает 5G.
Когда возможности узла запрашивают этот OID, минипорт-драйвер должен проверить, поддерживает ли базовое оборудование возможности сотовой связи 5G. Если это так, драйвер минипорта задает битовую маску в поле WwanDataClass структуры WWAN_DEVICE_CAPS_EX в соответствии с аппаратными ограничениями.
Кроме того, в поле WwanOptionalServiceCaps структуры WWAN_DEVICE_CAPS_EX определен новый необязательный бит службы, который охватывает поддержку всех новых расширений, связанных с 5G.
Дополнительные сведения о поддержке класса данных 5G см. в разделе MB 5G data class support.
Требования
Версия |
Windows 10 версии 1703 |
Заголовок |
Ntddndis.h (include Ndis.h) |