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 服务时,必须设置具有相同值的标头。
标头子member | 价值 |
---|---|
类型 | NDIS_OBJECT_TYPE_DEFAULT |
校订 | 支持 5G 设备的 Windows 10 版本 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
对于未经请求的事件(NDIS_STATUS_INDICATION::RequestId = 0),微型端口驱动程序必须将此设置为WWAN_STATUS_SUCCESS。 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
表示 MB 设备的注册状态的格式化 WWAN_REGISTRATION_STATE 对象。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7 及更高版本的 Windows 中可用。 |
标头 | ndiswwan.h (包括 Ndiswwan.h) |