OID_WWAN_RADIO_STATE

OID_WWAN_RADIO_STATE设置或返回有关 MB 设备的无线电电源状态的信息。

微型端口驱动程序必须异步处理集和查询请求,最初将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求,然后发送包含NDIS_WWAN_RADIO_STATE结构的NDIS_STATUS_WWAN_RADIO_STATE状态通知,该结构指示 MB 设备的当前无线电电源状态,而不考虑完成集或查询请求。

请求设置 MB 设备的无线电电源状态的调用方向微型端口驱动程序提供具有相应信息的 NDIS_WWAN_SET_RADIO_STATE 结构。

注解

有关使用此 OID 的详细信息,请参阅 MB 单选状态

处理查询或设置操作时,微型端口驱动程序不应访问提供程序网络或订阅者标识模块 (SIM 卡) 。

微型端口驱动程序必须在系统重启或设备移除和重新插入期间保留软件无线电电源状态。 微型端口驱动程序应存储设备的软件无线电信息,并在每次重启或重新插入设备时将其用于设置设备软件无线电电源状态。 根据 WWAN_RADIO_STATE 中的表,根据软件和硬件无线电电源状态的组合确定设备的有效无线电电源状态。

如果值为 WwanRadioOn,微型端口驱动程序必须打开无线电电源,并将 WWAN_RADIO_STATE 结构的 RadioState.SwRadioState 成员设置为 WwanRadioOn。 如果 RadioState.HwRadioState 成员为 WwanRadioOff,微型端口驱动程序应缓存此电源状态信息,并确保在 RadioState.HwRadioState 更改为 WwanRadioOn 时以物理方式打开无线电电源状态。

如果值为 WwanRadioOff,微型端口驱动程序必须关闭无线电电源状态,并将 RadioState.SwRadioState 成员设置为 WwanRadioOff

请参阅下表,了解微型端口驱动程序的预期无线电状态编程。

PIN 模式和 PIN 状态的有效组合

HwRadioState 值 SwRadioState 值 总体无线电电源状态

WwanRadioOff

WwanRadioOff

WwanRadioOff

WwanRadioOff

WwanRadioOn

WwanRadioOff

WwanRadioOn

WwanRadioOff

WwanRadioOff

WwanRadioOn

WwanRadioOn

WwanRadioOn

对于不提供硬件无线电电源开关的设备,必须始终将 NDIS_WWAN_RADIO_STATE 结构的 RadioState.HwRadioState 成员设置为 WwanRadioOn

从 Windows 10 版本 1703 开始,OID_WWAN_RADIO_STATE提供了有关多执行程序支持的调制解调器应如何处理 OS 中的无线电状态配置的其他规范。

使用支持多执行程序调制解调器的调制解调器时,配置每个执行器的无线电电源状态具有电源优势。 当执行程序的无线电关闭时,OS 希望调制解调器从网络中取消注册,并且不会尝试从网络进行任何扫描或位置更新。 调制解调器应支持它播发到 OS 的每个执行程序的无线电状态,以便它可以确定它应处于的硬件电源状态。

例如,如果调制解调器有两个执行程序,并且其中一个执行器的无线电在另一个打开时关闭,则调制解调器可以保持 RF 前端的通电状态,以保持其无线电已打开但不需要为已关闭的执行程序执行程序执行扫描/ping/位置更新或其他手机网络服务进行注册。 如果两个无线电都已关闭,调制解调器可以关闭其 RF 前端,并使整体硬件处于较低功率状态。 实现细节留给每个 IHV。

要求

版本

在 Windows 7 和更高版本的 Windows 中可用。

标头

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_WWAN_RADIO_STATE

NDIS_WWAN_SET_RADIO_STATE

NDIS_STATUS_WWAN_RADIO_STATE

MB 无线电状态

WWAN_RADIO_STATE