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 服务时,必须设置具有相同值的标头。

标头子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)

另请参阅

NDIS_OBJECT_HEADER

WWAN_REGISTRATION_STATE