OID_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX类似于 OID_WWAN_DEVICE_CAPS 但是每个执行程序 OID,这与OID_WWAN_DEVICE_CAPS不同,后者是每个设备的 OID。 此 OID 用于指示硬件的设备/执行程序功能,包括扩展可选功能(如 LTE 连接 APN 配置)的功能。

微型端口驱动程序必须异步处理查询请求,最初先将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求,然后再发送包含 NDIS_WWAN_DEVICE_CAPS_EX 结构的 NDIS_STATUS_WWAN_DEVICE_CAPS_EX 状态通知,后者又包含 WWAN_DEVICE_CAPS_EX 结构,以提供有关设备功能的信息。

下图演示了查询请求。

显示执行程序功能查询过程的示意图。

设置请求不适用。

注解

驱动程序将服务扩展功能作为一个整体报告(包括从驱动程序到实际设备)至关重要。 如果驱动程序支持某个服务,但基础硬件不支持该服务,则服务功能应标记为 FALSE。

OID_WWAN_DEVICE_CAPS_EX还用于检索每个执行程序的功能。 此 OID 在结构上与现有 OID_WWAN_DEVICE_CAPS相同, 但添加了 执行程序 ID。 微型端口驱动程序应报告它支持的最高 OID 版本。

OID_WWAN_DEVICE_CAPS 一样,此 OID 中的参数不会因 SIM 卡而更改,而是表示所选执行程序的调制解调器的 RF 功能。 物理硬件调制解调器可能有多个执行程序,因此可能有多个支持OID_WWAN_DEVICE_CAPS_EX的接口。

对于将来可能的更新,如果 OS 请求的版本高于设备支持的版本,则设备应返回它支持的 OID 结构的最新版本。 如果 OS 请求的版本早于设备支持的最新版本,则设备应返回与 OS 规范匹配的版本。 IHV 需要确保支持OID_WWAN_DEVICE_CAPS_EX的所有修订版以实现向后兼容性和旧支持。

与仅当调制解调器支持多 SIM/多执行程序时才需要Windows 10版本 1703 的其他 OID 不同,必须针对要从 Windows 10 版本 1703 开始支持任何 Microsoft 定义的服务扩展的调制解调器实现此 OID。

Windows 10版本 1703 之前的 Windows 版本可能仍使用现有OID_WWAN_DEVICE_CAPS;不支持使用支持多执行程序的调制解调器的行为。 IHV 必须定义此行为。

Windows 10 版本 1903

从 Windows 10 版本 1903 开始,OID_WWAN_DEVICE_CAPS_EX已升级到修订版 2。 如果微型端口驱动程序支持 5G,微型端口驱动程序必须使用此 OID 的修订版 2 及其包含的数据结构。

当主机使用此 OID 查询功能时,如果基础硬件支持 5G 手机网络功能,微型端口驱动程序必须检查。 如果存在,微型端口驱动程序会根据硬件上限在WWAN_DEVICE_CAPS_EX结构的 WwanDataClass 字段中设置位掩码。

此外,在WWAN_DEVICE_CAPS_EX结构的 WwanOptionalServiceCaps 字段中,定义了一个新的可选服务位,涵盖所有与 5G 相关的新扩展的支持。

有关 5G 数据类支持的详细信息,请参阅 MB 5G 数据类支持

要求

版本

Windows 10 版本 1703

标头

Ntddndis.h (包括 Ndis.h)

请参阅

OID_WWAN_DEVICE_CAPS

NDIS_STATUS_WWAN_DEVICE_CAPS_EX

NDIS_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS_EX