NDIS_WWAN_CONTEXT_STATE 结构 (ndiswwan.h)

  • 项目

NDIS_WWAN_CONTEXT_STATE结构表示数据包数据协议 (PDP) MB 设备的上下文状态。

语法

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

成员

Header

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

标头子成员 值
类型 NDIS_OBJECT_TYPE_DEFAULT
修订 Windows 8微型端口驱动程序应将此设置为 NDIS_WWAN_CONTEXT_STATE_REVISION_2。 Windows 7 微型端口驱动程序应将此设置为 NDIS_WWAN_CONTEXT_STATE_REVISION_1。
大小 sizeof (NDIS_WWAN_CONTEXT_STATE)
 

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

uStatus

上下文激活或停用操作的状态。 下表显示了此成员的可能值。

值 含义
WWAN_STATUS_SUCCESS 上下文激活或停用成功。
WWAN_STATUS_FAILURE 此操作失败。 如果已激活上下文，微型端口驱动程序可以返回此值。
WWAN_STATUS_PIN_REQUIRED 操作失败，因为设备需要 PIN。
WWAN_STATUS_BAD_SIM 操作失败，因为检测到错误的 SIM 卡。
WWAN_STATUS_SIM_NOT_INSERTED 操作失败，因为 SIM 卡未完全插入设备。
WWAN_STATUS_NOT_INITIALIZED 操作失败，因为设备正在初始化。 在设备的就绪状态更改为 WwanReadyStateInitialized 后重试该操作。
 

除了前面所述的) ，微型端口驱动程序可以返回以下错误代码 (仅在设置 PDP 激活操作失败时返回。

值 含义
WWAN_STATUS_RADIO_POWER_OFF 操作失败，因为无线电当前已关闭。 仅应返回此错误代码以响应OID_WWAN_CONNECT 集 请求。 如果无线电状态处于关闭状态，微型端口驱动程序应使用 WWAN_STATUS_SUCCESS 响应OID_WWAN_CONNECT 查询 请求，并将当前上下文状态指定为 WwanActivationStateDeactivated。
WWAN_STATUS_SERVICE_NOT_ACTIVATED 操作失败，因为订阅已过期，或者设备不允许 PDP 激活。
WWAN_STATUS_PROVIDER_NOT_VISIBLE 操作失败，因为服务提供程序当前不可见。
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS 操作失败，因为已达到最大激活上下文数。
WWAN_STATUS_INVALID_ACCESS_STRING 操作失败，因为访问字符串无效。
WWAN_STATUS_INVALID_USER_NAME_PWD 操作失败，因为提供的用户名和/或密码无效。 uNwError 中可能提供了特定于网络的错误代码。
WWAN_STATUS_PACKET_SVC_DETACHED 操作失败，因为数据包服务已分离。
WWAN_STATUS_NOT_REGISTERED 操作失败，因为设备未处于注册状态以执行 PDP 激活。
WWAN_STATUS_VOICE_CALL_IN_PROGRESS 操作失败，无法继续进行 PDP 激活，因为当前正在进行语音呼叫。 此值仅适用于语音类设置为 WwanVoiceClassSeparateVoiceData 的设备。
WWAN_STATUS_CONTEXT_NOT_ACTIVATED 操作失败，因为 ConnectionId 标识的上下文不是当前激活的上下文。

ContextState

一个格式化 WWAN_CONTEXT_STATE 对象，表示数据包数据协议 (PDP) 设备的上下文状态。

要求

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

另请参阅

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE