NDIS_WWAN_REGISTRATION_STATE 结构 (ndiswwan.h)

NDIS_WWAN_REGISTRATION_STATE结构表示 MB 设备的注册状态。

语法

typedef struct _NDIS_WWAN_REGISTRATION_STATE {
  NDIS_OBJECT_HEADER      Header;
  WWAN_STATUS             uStatus;
  WWAN_REGISTRATION_STATE RegistrationState;
} NDIS_WWAN_REGISTRATION_STATE, *PNDIS_WWAN_REGISTRATION_STATE;

成员

Header

包含有关NDIS_WWAN_REGISTRATION_STATE结构的类型、修订和大小信息的标头。 MB 服务在将数据结构发送到微型端口驱动程序进行 设置 操作时,使用下表中显示的值设置 标头。 微型端口驱动程序在将数据结构发送到 MB 服务时,必须使用相同的值设置 标头。

标头子成员
类型 NDIS_OBJECT_TYPE_DEFAULT
修订 Windows 10,支持 5G 设备的版本 1903 微型端口驱动程序应将此设置为NDIS_WWAN_REGISTRATION_STATE_REVISION_3。 Windows 8微型端口驱动程序应将此设置为NDIS_WWAN_REGISTRATION_STATE_REVISION_2。 Windows 7 微型端口驱动程序应将此设置为NDIS_WWAN_REGISTRATION_STATE_REVISION_1。
大小 sizeof (NDIS_WWAN_REGISTRATION_STATE)
 

有关这些成员的详细信息,请参阅 NDIS_OBJECT_HEADER

uStatus

微型端口驱动程序必须将此设置为WWAN_STATUS_SUCCESS未经请求的事件 (NDIS_STATUS_INDICATION::RequestId = 0) 。 WWAN_STATUS_SUCCESS也是为成功执行NDIS_WWAN_SET_REGISTER_STATE而设置的。

下表显示了其他可能的错误状态代码。

含义
WWAN_STATUS_PIN_REQUIRED 设备需要输入 PIN 值。
WWAN_STATUS_FAILURE 无法获取注册状态。
WWAN_STATUS_NOT_INITIALIZED 操作失败,因为设备正在初始化。 在设备的就绪状态更改为 WwanReadyStateInitialized 后重试该操作。
WWAN_STATUS_BAD_SIM 操作失败,因为检测到错误的 SIM 卡。
WWAN_STATUS_SIM_NOT_INSERTED 操作失败,因为 SIM 卡未完全插入设备。
 

除了上面列出的) ,微型端口驱动程序可以返回以下错误代码 (,前提是 PDP 激活 操作失败。

含义
WWAN_STATUS_FAILURE 无法设置注册状态。 有关详细信息,请参阅 uNwError 。 对于其他错误代码, uNwError 应设置为 0。
WWAN_STATUS_NO_DEVICE_SUPPORT 如果 设置 的注册请求用于手动注册,则基于 CDMA 的设备必须返回此错误代码。
WWAN_STATUS_SERVICE_NOT_ACTIVATED 服务激活失败。 订阅已过期。 设备不允许设置注册状态。
WWAN_STATUS_PROVIDER_NOT_VISIBLE 提供程序对于注册不可见。 这是用于手动注册的。
WWAN_STATUS_INVALID_PARAMETERS 如果请求是手动注册到禁止的提供程序。
WWAN_STATUS_BUSY 设备正忙,无法更改注册模式。 如果设备不允许在激活 PDP 上下文时更改注册模式,则可能会出现这种情况。

RegistrationState

一个格式化 WWAN_REGISTRATION_STATE 对象,表示 MB 设备的注册状态。

要求

要求
最低受支持的客户端 在 Windows 7 和更高版本的 Windows 中可用。
标头 ndiswwan.h (包括 Ndiswwan.h)

另请参阅

NDIS_OBJECT_HEADER

WWAN_REGISTRATION_STATE