通过

NDIS_WWAN_CONTEXT_STATE结构（ndiswwan.h）

  • 项目

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

语法

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

标头子member 价值
类型 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 集 请求时，才应返回此错误代码。 如果无线电状态处于关闭状态，微型端口驱动程序应响应OID_WWAN_CONNECT 查询 请求，WWAN_STATUS_SUCCESS并将当前上下文状态指定为 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

表示设备的数据包数据协议（PDP）上下文状态的格式化 WWAN_CONTEXT_STATE 对象。

要求

要求 价值
最低支持的客户端 在 Windows 7 及更高版本的 Windows 中可用。
标头 ndiswwan.h （包括 Ndiswwan.h）

另请参阅

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE