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) |